From 7347bac4ab7e136157fc94777e6cf87ef9e08599 Mon Sep 17 00:00:00 2001 From: Zhineng Li Date: Fri, 13 Feb 2026 10:54:11 +0800 Subject: first commit --- data/zh_cn/cddc/2020-03-20/api-docs.php | 7526 +++++++++++++++++++++++++++++++ 1 file changed, 7526 insertions(+) create mode 100644 data/zh_cn/cddc/2020-03-20/api-docs.php (limited to 'data/zh_cn/cddc') diff --git a/data/zh_cn/cddc/2020-03-20/api-docs.php b/data/zh_cn/cddc/2020-03-20/api-docs.php new file mode 100644 index 0000000..9fd5845 --- /dev/null +++ b/data/zh_cn/cddc/2020-03-20/api-docs.php @@ -0,0 +1,7526 @@ + '1.0', + 'info' => [ + 'style' => 'RPC', + 'product' => 'cddc', + 'version' => '2020-03-20', + ], + 'directories' => [ + [ + 'id' => 185350, + 'title' => '专有版API', + 'type' => 'directory', + 'children' => [ + 'CreateMyBase', + ], + ], + [ + 'id' => 185352, + 'title' => '托管版API', + 'type' => 'directory', + 'children' => [ + [ + 'id' => 101761, + 'title' => '地域', + 'type' => 'directory', + 'children' => [ + 'DescribeRegions', + ], + ], + [ + 'id' => 101764, + 'title' => '集群管理', + 'type' => 'directory', + 'children' => [ + 'CreateDedicatedHostGroup', + 'DeleteDedicatedHostGroup', + 'ModifyDedicatedHostGroupAttribute', + 'DescribeDedicatedHostGroups', + ], + ], + [ + 'id' => 101769, + 'title' => '主机管理', + 'type' => 'directory', + 'children' => [ + 'CreateDedicatedHost', + 'DescribeDedicatedHosts', + 'DescribeDedicatedHostAttribute', + 'DescribeHostEcsLevelInfo', + 'DescribeDedicatedHostDisks', + 'ModifyDedicatedHostAttribute', + 'ReplaceDedicatedHost', + 'RestartDedicatedHost', + 'DescribeHostWebShell', + 'ModifyDedicatedHostClass', + 'TagResources', + 'ListTagResources', + 'UntagResources', + ], + ], + [ + 'id' => 101794, + 'title' => '主机账号管理', + 'type' => 'directory', + 'children' => [ + 'CreateDedicatedHostAccount', + 'DeleteDedicatedHostAccount', + 'ModifyDedicatedHostPassword', + 'ModifyDedicatedHostAccount', + ], + ], + [ + 'id' => 101814, + 'title' => '实例管理', + 'type' => 'directory', + 'children' => [ + 'QueryHostInstanceConsoleInfo', + 'QueryHostBaseInfoByInstance', + ], + ], + ], + ], + [ + 'id' => 209190, + 'title' => '开放版 API', + 'type' => 'directory', + 'children' => [ + 'AddPrinsInstance', + 'CreatePrinsBackupPlan', + 'DescribePrinsInstance', + 'DescribePrinsBackupPlan', + 'DescribePrinsEcsInstances', + 'GetPrinsEventList', + 'GetPrinsMetricsList', + 'ListPrinsSQLErrorLog', + 'ListPrinsParams', + 'ListPrinsInstances', + ], + ], + ], + 'components' => [ + 'schemas' => [], + ], + 'apis' => [ + 'CreateMyBase' => [ + 'summary' => '创建MyBase专有版主机，如未提供集群信息会自动创建MyBase专有版集群。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '119494', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '[地域ID](~~198326~~)。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ap-southeast-1', + ], + ], + [ + 'name' => 'DedicatedHostGroupDescription', + 'in' => 'query', + 'allowEmptyValue' => true, + 'schema' => [ + 'title' => '集群名称，未传则为空', + 'description' => '专属集群的名称。', + 'type' => 'string', + 'required' => false, + 'docRequired' => false, + 'example' => 'testDedicatedGroupName', + ], + ], + [ + 'name' => 'Engine', + 'in' => 'query', + 'schema' => [ + 'title' => '引擎类型', + 'description' => '数据库类型，取值：'."\n" + .'- **alisql**。'."\n" + .'- **tair**。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'enumValueTitles' => [ + 'tair' => 'tair', + 'alisql' => 'alisql', + ], + 'example' => 'alisql', + ], + ], + [ + 'name' => 'SecurityGroupId', + 'in' => 'query', + 'schema' => [ + 'title' => '安全组ID', + 'description' => '安全组ID，可以指定多个安全组，多个安全组以英文逗号（,）分隔，传入格式为sg-t4neld965n89ocvt****,sg-t4neld965n89ocvu****。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'sg-t4neld965n89ocvt****,sg-t4neld965n89ocvu****', + ], + ], + [ + 'name' => 'ZoneId', + 'in' => 'query', + 'schema' => [ + 'description' => '可用区ID，您可以调用[DescribeRegions](~~214103~~)查看地域下的可用区ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ap-southeast-1a', + ], + ], + [ + 'name' => 'VSwitchId', + 'in' => 'query', + 'schema' => [ + 'description' => '虚拟交换机ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'vsw-t4ni3mzqqw98vt317****', + ], + ], + [ + 'name' => 'ECSClassList', + 'in' => 'query', + 'allowEmptyValue' => false, + 'style' => 'json', + 'schema' => [ + 'description' => 'ECS规格信息。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'sysDiskCapacity' => [ + 'description' => '系统盘容量，单位为GB。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => true, + 'minimum' => '40', + 'example' => '40', + ], + 'instanceType' => [ + 'description' => 'ECS规格。', + 'type' => 'string', + 'required' => true, + 'example' => 'ecs.c6.large', + ], + 'nodeCount' => [ + 'description' => 'ECS购买数量。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => true, + 'example' => '1', + ], + 'sysDiskType' => [ + 'description' => '系统盘磁盘类型，取值：'."\n" + ."\n" + .'- **cloud_essd**。'."\n" + ."\n" + .'- **cloud_ssd**。'."\n" + ."\n" + .'- **cloud_efficiency**。'."\n" + ."\n" + .'- **cloud**。', + 'type' => 'string', + 'required' => true, + 'example' => 'cloud_essd', + 'enum' => [ + 'cloud_essd', + 'cloud_ssd', + 'cloud_efficiency', + 'cloud', + ], + ], + 'diskType' => [ + 'description' => '数据盘类型，取值：'."\n" + .'- **cloud_essd**。'."\n" + ."\n" + .'- **cloud_ssd**。'."\n" + ."\n" + .'- **cloud_efficiency**。'."\n" + ."\n" + .'- **cloud**。', + 'type' => 'string', + 'required' => false, + 'example' => 'cloud_essd', + 'enum' => [ + 'cloud_essd', + 'cloud_ssd', + 'cloud_efficiency', + 'cloud', + ], + ], + 'diskCapacity' => [ + 'description' => '数据盘容量。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '50', + ], + 'diskCount' => [ + 'description' => '挂载数据盘个数。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '1', + ], + 'dataDiskPerformanceLevel' => [ + 'description' => '数据盘PL等级。', + 'type' => 'string', + 'required' => false, + 'example' => 'PL1', + 'enum' => [ + 'PL0', + 'PL1', + 'PL2', + 'PL3', + ], + ], + 'systemDiskPerformanceLevel' => [ + 'description' => '系统盘PL等级。', + 'type' => 'string', + 'required' => false, + 'example' => 'PL1', + 'enum' => [ + 'PL0', + 'PL1', + 'PL2', + 'PL3', + ], + ], + 'sysDiskAutoSnapshotPolicyId' => [ + 'description' => '系统盘快照策略。', + 'type' => 'string', + 'required' => false, + 'example' => 'sp-bp1i9wclcwpe52th****', + ], + 'sysDiskEncrypted' => [ + 'description' => '系统盘是否加密，系统盘只有为ESSD云盘时才可以设置。', + 'type' => 'boolean', + 'required' => false, + 'example' => 'false', + ], + 'sysDiskKMSKeyId' => [ + 'description' => '系统盘使用的KMS密钥ID，使用ECS默认加密服务时不用传值，系统盘只有为ESSD云盘时才可以设置。', + 'type' => 'string', + 'required' => false, + 'example' => 'b3c210f3-3ffb-480e-9ca2-****', + ], + 'dataDiskAutoSnapshotPolicyId' => [ + 'description' => '数据盘快照策略。', + 'type' => 'string', + 'required' => false, + 'example' => 'sp-bp1i9wclcwpe52th****', + ], + 'dataDiskEncrypted' => [ + 'description' => '数据盘是否加密。', + 'type' => 'boolean', + 'required' => false, + 'example' => 'false', + ], + 'dataDiskKMSKeyId' => [ + 'description' => '数据盘使用的KMS密钥ID，使用ECS默认加密服务时不用传值。', + 'type' => 'string', + 'required' => false, + 'example' => 'b3c210f3-3ffb-480e-9ca2-****', + ], + ], + 'required' => true, + ], + 'required' => true, + 'docRequired' => true, + 'example' => '[{"sysDiskCapacity":40,"instanceType":"ecs.d2s.10xlarge","nodeCount":1,"sysDiskType":"cloud_essd"}]', + ], + ], + [ + 'name' => 'PayType', + 'in' => 'query', + 'schema' => [ + 'description' => '付费类型，目前仅支持**PrePaid**。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'PrePaid', + 'enum' => [ + 'PrePaid', + ], + ], + ], + [ + 'name' => 'Period', + 'in' => 'query', + 'schema' => [ + 'description' => '购买时长。', + 'type' => 'string', + 'required' => false, + 'docRequired' => true, + 'example' => '1', + 'default' => '1', + ], + ], + [ + 'name' => 'ClientToken', + 'in' => 'query', + 'schema' => [ + 'description' => '保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。', + 'type' => 'string', + 'required' => false, + 'docRequired' => false, + 'example' => '4ed77dd1-ff52-407e-ac58-dc251822****', + ], + ], + [ + 'name' => 'AutoRenew', + 'in' => 'query', + 'schema' => [ + 'description' => '是否开启自动续费，取值：'."\n" + ."\n" + .'- **true**：开启。'."\n" + ."\n" + .'- **false**（默认值）：关闭。'."\n" + ."\n", + 'type' => 'string', + 'required' => false, + 'example' => 'false', + 'default' => 'false', + ], + ], + [ + 'name' => 'ImageId', + 'in' => 'query', + 'allowEmptyValue' => true, + 'schema' => [ + 'title' => '镜像ID', + 'description' => '自定义镜像ID。'."\n" + ."\n" + .'> 若您需要使用默认镜像，无需填写。', + 'type' => 'string', + 'required' => false, + 'example' => 'm-8vb11a30rc63x37c****', + ], + ], + [ + 'name' => 'OsPassword', + 'in' => 'query', + 'allowEmptyValue' => false, + 'schema' => [ + 'description' => '主机登录密码，可以稍后设置。密码须符合如下要求：'."\n" + ."\n" + .'- 长度为8~30个字符。'."\n" + ."\n" + .'- 必须至少包含三项：大写字母、小写字母、数字和特殊字符。'."\n" + ."\n" + .'- 特殊符号`()\\`~!@#$%^&*-_+=|{}[]:;\'<>,.?/`'."\n" + ."\n" + .'> - 如果需要稍后设置主机登录密码，此参数填写空字符串即可。'."\n" + .'> - 如果需要设置主机登录密码，建议您使用HTTPS协议发送请求，避免密码泄露。', + 'type' => 'string', + 'required' => false, + 'example' => 'Test123456', + ], + ], + [ + 'name' => 'DedicatedHostGroupId', + 'in' => 'query', + 'schema' => [ + 'description' => '已有专有版专属集群ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'dhg-6dx5n9gjs96u****', + ], + ], + [ + 'name' => 'PeriodType', + 'in' => 'query', + 'schema' => [ + 'description' => '预付费类型，目前仅支持**Monthly**（包月）。', + 'type' => 'string', + 'required' => false, + 'example' => 'Monthly', + 'default' => 'Monthly', + 'enum' => [ + 'Monthly', + 'Weekly', + ], + ], + ], + [ + 'name' => 'VpcId', + 'in' => 'query', + 'schema' => [ + 'description' => '专有网络VPCID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'vpc-t4nbtmekgxotv0d3y****', + ], + ], + [ + 'name' => 'KeyPairName', + 'in' => 'query', + 'schema' => [ + 'description' => '密钥对名称。', + 'type' => 'string', + 'required' => false, + 'example' => 'test_key_pair', + ], + ], + [ + 'name' => 'PasswordInherit', + 'in' => 'query', + 'schema' => [ + 'description' => '是否使用镜像的默认密码。'."\n" + ."\n" + .'- **false**（默认值）：不使用'."\n" + ."\n" + .'- **true**：使用'."\n" + ."\n" + .'> 若使用镜像的默认密码，**OSPassword**参数无需填写。', + 'type' => 'string', + 'required' => false, + 'example' => 'false', + ], + ], + [ + 'name' => 'EcsHostName', + 'in' => 'query', + 'schema' => [ + 'description' => 'Windows系统：长度为2～15个字符，允许使用大小写字母、数字。不能仅使用数字。'."\n" + .'其他操作系统（Linux等）：长度为2～64个字符，允许使用点号（.）分隔字符成多段，每段允许使用大小写字母、数字，但不能连续使用点号（.）。不能以点号（.）开头或结尾。', + 'type' => 'string', + 'required' => false, + 'example' => 'LocalHostname', + ], + ], + [ + 'name' => 'EcsInstanceName', + 'in' => 'query', + 'schema' => [ + 'description' => '实例名称。长度为2~128个字符，必须以大小写字母或中文开头，不能以http://和https://开头。可以包含中文、英文、数字、半角冒号（:）、下划线（_）、半角句号（.）或者短划线（-）。默认值为实例的InstanceId。', + 'type' => 'string', + 'required' => false, + 'example' => 'k8snode1', + ], + ], + [ + 'name' => 'EcsDeploymentSetId', + 'in' => 'query', + 'schema' => [ + 'description' => '云服务器部署集ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'ds-bp1brhwhoqinyjd6****', + ], + ], + [ + 'name' => 'EcsUniqueSuffix', + 'in' => 'query', + 'schema' => [ + 'description' => '当创建多台实例时，是否为HostName和InstanceName自动添加有序后缀。有序后缀从001开始递增，最大不能超过999。取值说明：'."\n" + ."\n" + .'- **true**：添加。'."\n" + ."\n" + .'- **false**（默认值）：不添加。'."\n" + ."\n" + .'当HostName或InstanceName按照指定排序格式设置，未设置命名后缀name_suffix，即命名格式为name_prefix[begin_number,bits]时，UniqueSuffix不生效，名称仅按照指定顺序排序。', + 'type' => 'string', + 'required' => false, + 'example' => 'false', + 'default' => 'false', + ], + ], + [ + 'name' => 'InternetChargeType', + 'in' => 'query', + 'schema' => [ + 'description' => '网络计费类型。取值范围：'."\n" + .'PayByBandwidth：按固定带宽计费。'."\n" + .'PayByTraffic：按使用流量计费。', + 'type' => 'string', + 'required' => false, + 'enumValueTitles' => [ + 'PayByTraffic' => 'PayByTraffic', + 'PayByBandwidth' => 'PayByBandwidth', + ], + 'example' => 'PayByBandwidth', + 'default' => 'PayByBandwidth', + ], + ], + [ + 'name' => 'InternetMaxBandwidthOut', + 'in' => 'query', + 'schema' => [ + 'description' => '公网出带宽最大值，单位为Mbit/s。取值范围：0~100。'."\n" + ."\n" + .'默认值：0。设定为大于0时会自动创建公网IP。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '0', + ], + ], + [ + 'name' => 'AutoPay', + 'in' => 'query', + 'schema' => [ + 'description' => '创建主机时，是否自动支付。'."\n" + ."\n" + .'- **false**：只生成订单不扣费，需要在【我的订单】页面手动确认支付。'."\n" + ."\n" + .'- **true**（默认值）：自动支付，请确保支付方式余额充足，否则会生成异常订单，只能作废订单。', + 'type' => 'boolean', + 'required' => false, + 'example' => 'false', + 'default' => 'true', + ], + ], + [ + 'name' => 'ResourceGroupId', + 'in' => 'query', + 'schema' => [ + 'description' => '资源组ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'rg-bp67acfmxazb4p****', + ], + ], + [ + 'name' => 'UserDataInBase64', + 'in' => 'query', + 'schema' => [ + 'description' => '自定义数据是否采用Base64格式编码。', + 'type' => 'boolean', + 'required' => false, + 'example' => 'true', + 'default' => 'false', + ], + ], + [ + 'name' => 'UserData', + 'in' => 'query', + 'schema' => [ + 'description' => '用户自定义脚本数据，原始数据最多为16KB。', + 'type' => 'string', + 'required' => false, + 'example' => 'ZWNobyBoZWxsbyBlY3Mh', + ], + ], + [ + 'name' => 'Tags', + 'in' => 'query', + 'style' => 'json', + 'schema' => [ + 'description' => '主机标签信息。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Key' => [ + 'description' => '主机的标签键。一旦传入该值，则不允许为空字符串。最多支持128个字符，不能以aliyun和acs:开头，不能包含http://或 https://。', + 'type' => 'string', + 'required' => false, + 'example' => 'TestKey', + ], + 'Value' => [ + 'description' => '主机的标签值。一旦传入该值，则不允许为空字符串。最多支持128个字符，不能以acs:开头，不能包含http://或 https://。', + 'type' => 'string', + 'required' => false, + 'example' => 'TestValue', + ], + ], + 'required' => false, + ], + 'required' => false, + 'maxItems' => 18, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => '937F6B32-A796-53A0-99C8-F7A9660E****', + ], + 'OrderList' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'OrderList' => [ + 'description' => '订单列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'OrderId' => [ + 'description' => '订单ID。', + 'type' => 'string', + 'example' => '21767077790****', + ], + 'CreateTimestamp' => [ + 'description' => '主机创建成功的时间戳。', + 'type' => 'integer', + 'format' => 'int64', + 'example' => '1661498032347', + ], + 'ECSInstanceIds' => [ + 'description' => '已创建成功的ECS主机ID，多个主机ID以英文逗号（,）分隔。', + 'type' => 'string', + 'example' => '["i-t4n1tandot8j3axw****","i-t4n1tandot8j3axv****"]', + ], + 'DedicatedHostGroupName' => [ + 'description' => '创建的专有版集群ID。', + 'type' => 'string', + 'example' => 'dhg-7a9********', + ], + ], + ], + ], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'InvalidParameter', + 'errorMessage' => 'The parameter is invalid.', + ], + [ + 'errorCode' => 'COMMODITY.INVALID_COMPONENT', + 'errorMessage' => 'Invalid component.', + ], + [ + 'errorCode' => 'InvalidAccountPassword.Format', + 'errorMessage' => 'The account password format is invalid.', + ], + [ + 'errorCode' => 'InsufficientResourceCapacity', + 'errorMessage' => 'No host is available for the requested instance.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"937F6B32-A796-53A0-99C8-F7A9660E****\\",\\n \\"OrderList\\": {\\n \\"OrderList\\": [\\n {\\n \\"OrderId\\": \\"21767077790****\\",\\n \\"CreateTimestamp\\": 1661498032347,\\n \\"ECSInstanceIds\\": \\"[\\\\\\"i-t4n1tandot8j3axw****\\\\\\",\\\\\\"i-t4n1tandot8j3axv****\\\\\\"]\\",\\n \\"DedicatedHostGroupName\\": \\"dhg-7a9********\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 937F6B32-A796-53A0-99C8-F7A9660E****\\n \\n 21767077790****\\n 1661498032347\\n [\\"i-t4n1tandot8j3axv****\\"]\\n dhg-7a9********\\n \\n","errorExample":""}]', + 'title' => 'CreateMyBase', + ], + 'DescribeRegions' => [ + 'summary' => '调用DescribeRegions接口查看地域ID。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74517', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22ECB1F', + ], + 'Regions' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'RDSRegion' => [ + 'description' => '地域详情信息列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ZoneId' => [ + 'description' => '地域下的可用区ID。', + 'type' => 'string', + 'example' => 'ap-southeast-1a', + ], + 'RegionId' => [ + 'description' => '地域ID。', + 'type' => 'string', + 'example' => 'ap-southeast-1', + ], + ], + ], + ], + ], + ], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22ECB1F\\",\\n \\"Regions\\": {\\n \\"RDSRegion\\": [\\n {\\n \\"ZoneId\\": \\"ap-southeast-1a\\",\\n \\"RegionId\\": \\"ap-southeast-1\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\nD6E068C3-25BC-455A-85FE-45F0B22ECB1F\\n\\n \\n ap-southeast-1a\\n ap-southeast-1\\n \\n\\n","errorExample":""}]', + 'title' => '查看可选的地域和可用区', + 'description' => '关于各个地域对应的ID，请参见[地域信息](~~198326~~)。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'CreateDedicatedHostGroup' => [ + 'summary' => '调用CreateDedicatedHostGroup接口创建专属集群。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '76545', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'Engine', + 'in' => 'query', + 'schema' => [ + 'description' => '数据库引擎类型，取值：'."\n" + ."\n" + .'- **MySQL**'."\n" + .'- **SQL Server**'."\n" + .''."\n" + .'- **Redis**'."\n" + ."\n\n" + .''."\n" + ."\n", + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'MySQL', + ], + ], + [ + 'name' => 'CpuAllocationRatio', + 'in' => 'query', + 'schema' => [ + 'description' => ' 专属集群的CPU超配比。'."\n" + ."\n" + .'> 取值范围：**100%**~**300%**，默认取值为**200%**，代表所有实例的CPU资源之和可以是实际CPU资源的2倍，充分利用资源。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '200', + ], + ], + [ + 'name' => 'MemAllocationRatio', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群中每台主机的内存最大使用率。'."\n" + ."\n" + .'> 取值范围：**0%**~**100%**，默认取值为**100%**。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '100', + ], + ], + [ + 'name' => 'DiskAllocationRatio', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群的空间超配比。'."\n" + ."\n" + .'> 取值范围：**100%**~**300%**，默认取值为**200%**，代表所有实例的空间资源之和可以是实际空间资源的2倍，充分利用资源。该设置对于 SQLServer 无效。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '200', + ], + ], + [ + 'name' => 'AllocationPolicy', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群资源调度的分配策略。取值：'."\n" + .'- **Evenly**（默认）：均衡分配，最大化追求更稳定的系统表现，优先从未分配资源或已分配资源较少的主机中分配资源。'."\n" + .'- **Intensively**：紧凑分配，最大化追求更充分的资源利用率，优先从创建时间较早且已分配资源较多的主机中分配资源。', + 'type' => 'string', + 'required' => false, + 'example' => 'Evenly', + ], + ], + [ + 'name' => 'VPCId', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群归属的专有网络ID，可在专有网络控制台左侧单击**专有网络**查看目标专有网络ID。'."\n", + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'vpc-t4n7v5m6icc0a4314****', + ], + ], + [ + 'name' => 'HostReplacePolicy', + 'in' => 'query', + 'schema' => [ + 'description' => '主机故障时系统的处理策略。取值：'."\n" + ."\n" + .'- **Auto**（默认）：自动替换主机。'."\n" + .'- **Manual**：手动替换主机。'."\n" + ."\n" + .'> 仅创建数据库引擎为**MySQL**的专属集群时，您可以根据实际需求选择主机故障处理策略。其余引擎均请使用**Auto**默认值。', + 'type' => 'string', + 'required' => false, + 'example' => 'Auto', + ], + ], + [ + 'name' => 'ClientToken', + 'in' => 'query', + 'schema' => [ + 'description' => '客户端生成该参数值，用于保证请求的幂等性，防止重复提交请求。该参数值只能包含ASCII字符，且不超过64个ASCII字符。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ETnLKlblzczshOTUbOCz*******', + ], + ], + [ + 'name' => 'OpenPermission', + 'in' => 'query', + 'schema' => [ + 'description' => '是否开放专属集群内的主机的OS权限。取值：'."\n" + ."\n" + .'- **0**：关闭。'."\n" + .'- **1**：开放。'."\n" + ."\n" + .'> 仅创建数据库引擎为**MySQL、SQL Server**的专属集群时，您可以根据实际需求选择主机开放OS权限。其余引擎暂未提供主机开放OS权限功能，该参数取值默认为**关闭**。SQLServer 必须要指定开放权限（1）。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '1', + ], + ], + [ + 'name' => 'DedicatedHostGroupDesc', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群的名称。长度为1~64个字符，以大小字母或中文开头，可包含数字、下划线（_）或中划线（-）。', + 'type' => 'string', + 'required' => false, + 'example' => 'mysqlcluster', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'C6592723-09E1-4248-A78E-12AB00D7A79D', + ], + 'DedicatedHostGroupId' => [ + 'description' => '创建的专属集群ID。', + 'type' => 'string', + 'example' => 'dhg-7a9********', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + [ + 'errorCode' => 'Permission.NotSupport', + 'errorMessage' => 'You are not authorized to perform this action.', + ], + ], + [ + [ + 'errorCode' => 'ClustersTemplateNotFound', + 'errorMessage' => 'Key account cluster is not supported for the region.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C6592723-09E1-4248-A78E-12AB00D7A79D\\",\\n \\"DedicatedHostGroupId\\": \\"dhg-7a9********\\"\\n}","errorExample":""},{"type":"xml","example":"\\nC6592723-09E1-4248-A78E-12AB00D7A79D\\ndhg-7a9********\\n","errorExample":""}]', + 'title' => '创建专属集群', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'DeleteDedicatedHostGroup' => [ + 'summary' => '调用DeleteDedicatedHostGroup接口删除专属集群。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'delete', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74478', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'DedicatedHostGroupId', + 'in' => 'query', + 'schema' => [ + 'description' => '目标专属集群ID。可通过云数据库专属集群控制台的集群列表信息页查看。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'dhg-h5i4p331f509****', + ], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '目标专属集群所在地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'required' => false, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22E1765', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'Host.Exist', + 'errorMessage' => 'There are hosts in usercluster, can\'t delete it.', + ], + [ + 'errorCode' => 'Custins.Exist', + 'errorMessage' => 'The cluster contains an instance and cannot be deleted.', + ], + ], + 404 => [ + [ + 'errorCode' => 'InvalidDedicatedHostGroup.NotFound', + 'errorMessage' => 'Specified DedicatedHostGroup does not exists.', + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22E1765\\"\\n}","type":"json"}]', + 'title' => '删除专属集群', + ], + 'ModifyDedicatedHostGroupAttribute' => [ + 'summary' => '可修改的配置包括 CPU 超配比、内存使用率、空间超配比、资源分布策略等。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74529', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群所在地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'required' => false, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'DedicatedHostGroupId', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群ID。'."\n" + ."\n" + .'> 您可通过云数据库专属集群控制台集群列表查看目标专属集群ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'dhg-h5i4p331f509****', + ], + ], + [ + 'name' => 'DedicatedHostGroupDesc', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群的名称。', + 'type' => 'string', + 'required' => false, + 'example' => 'mysql-cluster', + ], + ], + [ + 'name' => 'CpuAllocationRatio', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群的CPU超配比，取值范围：**100%**~**300%**。'."\n" + ."\n" + .'> 若您修改CPUC超配比为**300%**，代表所有实例的CPU资源之和是实际CPU资源的3倍，最大化使用CPU资源。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '300', + ], + ], + [ + 'name' => 'MemAllocationRatio', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群中每台主机的内存最大使用率。取值范围：**0%**~**100%**。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '100', + ], + ], + [ + 'name' => 'DiskAllocationRatio', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群的空间超配比。取值范围：**100%**~**200%**。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '200', + ], + ], + [ + 'name' => 'AllocationPolicy', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群资源调度的分配策略。取值：'."\n" + .'- **Evenly**：均衡分配，最大化追求更稳定的系统表现，优先从未分配资源或已分配资源较少的主机中分配资源。'."\n" + .'- **Intensively**：紧凑分配，最大化追求更充分的资源利用率，优先从创建时间较早且已分配资源较多的主机中分配资源。', + 'type' => 'string', + 'required' => false, + 'example' => 'Intensively', + ], + ], + [ + 'name' => 'HostReplacePolicy', + 'in' => 'query', + 'schema' => [ + 'description' => '主机故障时系统的处理策略。取值：'."\n" + ."\n" + .'- **Auto**：自动替换主机。'."\n" + .'- **Manual**：手动替换主机。'."\n" + ."\n" + .'> 仅创建数据库引擎为**MySQL**的专属集群时，您可以根据实际需求选择主机故障处理策略。其余引擎均请使用Auto默认值。', + 'type' => 'string', + 'required' => false, + 'example' => 'Auto', + ], + ], + [ + 'name' => 'OpenPermission', + 'in' => 'query', + 'schema' => [ + 'description' => '是否开放专属集群内的主机的OS权限。取值：'."\n" + ."\n" + .'- **0**：关闭'."\n" + .'- **1**：开放'."\n" + ."\n" + .'> 仅创建数据库引擎为**MySQL、SQL Server、PostgreSQL**的专属集群时，您可以根据实际需求选择主机开放OS权限。其余引擎暂未提供主机开放OS权限功能，该参数取值默认为关闭。', + 'type' => 'string', + 'required' => false, + 'example' => '0', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22EEDAS', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'InvalidUserId.NotSupport', + 'errorMessage' => 'The userid have no permission.', + ], + ], + 403 => [ + [ + 'errorCode' => 'Forbidden.RAM', + 'errorMessage' => 'User not authorized to operate on the specified resource, or this API does not support RAM.', + ], + ], + [ + [ + 'errorCode' => 'InvalidDedicatedHostGroup.NotFound', + 'errorMessage' => '找不到目标主机组！', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22EEDAS\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\nD6E068C3-25BC-455A-85FE-45F0B22EEDAS\\r\\n","errorExample":""}]', + 'title' => '修改专属集群的配置', + 'description' => '更多信息，请参见[管理集群](~~182328~~)。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'DescribeDedicatedHostGroups' => [ + 'summary' => '查询专有集群主机组信息。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74491', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'DedicatedHostGroupId', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群ID。您可通过云数据库专属集群控制台集群列表查看目标专属集群ID。'."\n" + ."\n" + .' - 该参数为空时，默认返回该地域内所有主机信息。'."\n" + .' - 若传入具体的专属集群ID，则返回该地域该集群内所有主机信息。'."\n" + ."\n\n" + .' ', + 'type' => 'string', + 'required' => false, + 'example' => 'dhg-872yt76ann7e****', + ], + ], + [ + 'name' => 'ImageCategory', + 'in' => 'query', + 'schema' => [ + 'description' => '主机镜像。取值：'."\n" + ."\n" + .'- **WindowsWithMssqlEntAlwaysonLicense**：SQL'."\n" + ."\n" + .' Server集群版'."\n" + ."\n" + .'- **WindowsWithMssqlStdLicense**：SQL'."\n" + ."\n" + .' Server标准版'."\n" + ."\n" + .'- **WindowsWithMssqlEntLicense**：SQL'."\n" + ."\n" + .' Server企业版'."\n" + ."\n" + .'- **WindowsWithMssqlWebLicense**：SQL'."\n" + ."\n" + .' Server Web版'."\n" + ."\n" + .'- **AliLinux**：其他主机镜像。', + 'type' => 'string', + 'required' => false, + 'example' => 'AliLinux', + ], + ], + [ + 'name' => 'Engine', + 'in' => 'query', + 'schema' => [ + 'description' => '根据数据库引擎类型过滤主机列表。取值：'."\n" + ."\n" + .'
  • MySQL
    • '."\n" + .'
  • SQL Server
    • '."\n" + .'
  • PosgreSQL
    • '."\n" + .'
  • Redis
    • ', + 'type' => 'string', + 'required' => false, + 'example' => 'MySQL', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22E12SD', + ], + 'DedicatedHostGroups' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'DedicatedHostGroups' => [ + 'description' => '主机详细信息。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DiskAllocateRation' => [ + 'description' => '磁盘分配率。', + 'type' => 'number', + 'format' => 'float', + 'example' => '100', + ], + 'DeployType' => [ + 'description' => '实例部署方式。'."\n", + 'type' => 'string', + 'example' => 'origin', + ], + 'CreateTime' => [ + 'description' => '主机创建时间。', + 'type' => 'string', + 'example' => '2021-05-07T02:00Z', + ], + 'DedicatedHostCountGroupByHostType' => [ + 'description' => '不同存储类型对应的主机数量。', + 'type' => 'object', + 'example' => '2', + ], + 'Text' => [ + 'description' => '主机描述。', + 'type' => 'string', + 'example' => 'mysql-host', + ], + 'DedicatedHostGroupId' => [ + 'description' => '主机所属专属集群ID。', + 'type' => 'string', + 'example' => ' dhg-34639v1jt4y4****', + ], + 'DiskUtility' => [ + 'description' => '磁盘利用率。', + 'type' => 'number', + 'format' => 'float', + 'example' => '0', + ], + 'MemUsedAmount' => [ + 'description' => '内存使用量。', + 'type' => 'number', + 'format' => 'float', + 'example' => '0', + ], + 'MemAllocatedAmount' => [ + 'description' => '内存分配量。', + 'type' => 'number', + 'format' => 'float', + 'example' => '0', + ], + 'CpuAllocationRatio' => [ + 'description' => '主机CPU超配比。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '200', + ], + 'MemAllocationRatio' => [ + 'description' => '主机内存超配比。'."\n" + ."\n", + 'type' => 'integer', + 'format' => 'int32', + 'example' => '100', + ], + 'MemAllocateRation' => [ + 'description' => '分配的内存比例。', + 'type' => 'number', + 'format' => 'float', + 'example' => '9.38', + ], + 'MemUtility' => [ + 'description' => '内存利用率。', + 'type' => 'number', + 'format' => 'float', + 'example' => '0', + ], + 'CpuAllocatedAmount' => [ + 'description' => 'CPU申请量。', + 'type' => 'number', + 'format' => 'float', + 'example' => '3', + ], + 'DedicatedHostGroupDesc' => [ + 'description' => '主机所属专属集群名称。', + 'type' => 'string', + 'example' => ' dhg-34639v1jt4y4****', + ], + 'CpuAllocateRation' => [ + 'description' => 'CPU申请比例', + 'type' => 'number', + 'format' => 'float', + 'example' => '9.38', + ], + 'InstanceNumber' => [ + 'description' => '主机上实例数量。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '2', + ], + 'OpenPermission' => [ + 'description' => '主机OS权限。取值：'."\n" + ."\n" + .'- **0、1**：关闭'."\n" + ."\n" + .'- **2、3**（默认值）：开放'."\n" + ."\n" + .'> 创建数据库引擎为**MySQL**、**SQL Server**、**PostgreSQL**的专属集群时，您可以根据实际需求选择主机开放OS权限。'."\n", + 'type' => 'string', + 'example' => '1', + ], + 'VPCId' => [ + 'description' => '主机所属专属集群专有网络ID。', + 'type' => 'string', + 'example' => 'vpc-bp1ov7as4yvz4kxei****', + ], + 'DiskAllocatedAmount' => [ + 'description' => '磁盘分配容量。', + 'type' => 'number', + 'format' => 'float', + 'example' => '1024', + ], + 'HostNumber' => [ + 'description' => '主机数量。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '2', + ], + 'DiskUsedAmount' => [ + 'description' => '磁盘使用量。', + 'type' => 'number', + 'format' => 'float', + 'example' => '1024', + ], + 'AllocationPolicy' => [ + 'description' => '主机资源分配策略，取值：'."\n" + .'- **Evenly**：均衡分配，最大化追求更稳定的系统表现，优先从未分配资源或已分配资源较少的主机中分配资源。'."\n" + .'- **Intensively**：紧凑分配，最大化追求更充分的资源利用率，优先从创建时间较早且已分配资源较多的主机中分配资源。', + 'type' => 'string', + 'example' => 'Evenly', + ], + 'Engine' => [ + 'description' => '主机数据库引擎类型。', + 'type' => 'string', + 'example' => 'MySQL', + ], + 'DiskAllocationRatio' => [ + 'description' => '主机空间超配比。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '200', + ], + 'BastionInstanceId' => [ + 'description' => '主机的主实例D。若主机上无主实例，则返回空字符串。', + 'type' => 'string', + 'example' => 'rm-bp15rszyxs4t3****', + ], + 'HostReplacePolicy' => [ + 'description' => '主机故障处理策略。取值：'."\n" + ."\n" + .'- Auto（默认）：自动替换主机。'."\n" + ."\n" + .'- Manual：手动替换主机。', + 'type' => 'string', + 'example' => 'Auto', + ], + 'ZoneIDList' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'ZoneIDList' => [ + 'description' => '主机可用区列表。', + 'type' => 'array', + 'items' => [ + 'description' => '主机可用区列表。', + 'type' => 'string', + 'example' => 'cn-hangzhou-f', + ], + ], + ], + ], + 'Category' => [ + 'description' => '主机所属的专属集群系列。取值：'."\n" + ."\n" + .'- **Pro**：MyBase专有版集群'."\n" + ."\n" + .'- **Standard**：MyBase托管版集群', + 'type' => 'string', + 'example' => 'Pro', + ], + ], + ], + ], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + [ + 'errorCode' => 'Permission.NotSupport', + 'errorMessage' => 'You are not authorized to perform this action.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22E12SD\\",\\n \\"DedicatedHostGroups\\": {\\n \\"DedicatedHostGroups\\": [\\n {\\n \\"DiskAllocateRation\\": 100,\\n \\"DeployType\\": \\"origin\\",\\n \\"CreateTime\\": \\"2021-05-07T02:00Z\\",\\n \\"DedicatedHostCountGroupByHostType\\": 2,\\n \\"Text\\": \\"mysql-host\\",\\n \\"DedicatedHostGroupId\\": \\" dhg-34639v1jt4y4****\\",\\n \\"DiskUtility\\": 0,\\n \\"MemUsedAmount\\": 0,\\n \\"MemAllocatedAmount\\": 0,\\n \\"CpuAllocationRatio\\": 200,\\n \\"MemAllocationRatio\\": 100,\\n \\"MemAllocateRation\\": 9.38,\\n \\"MemUtility\\": 0,\\n \\"CpuAllocatedAmount\\": 3,\\n \\"DedicatedHostGroupDesc\\": \\" dhg-34639v1jt4y4****\\",\\n \\"CpuAllocateRation\\": 9.38,\\n \\"InstanceNumber\\": 2,\\n \\"OpenPermission\\": \\"1\\",\\n \\"VPCId\\": \\"vpc-bp1ov7as4yvz4kxei****\\",\\n \\"DiskAllocatedAmount\\": 1024,\\n \\"HostNumber\\": 2,\\n \\"DiskUsedAmount\\": 1024,\\n \\"AllocationPolicy\\": \\"Evenly\\",\\n \\"Engine\\": \\"MySQL\\",\\n \\"DiskAllocationRatio\\": 200,\\n \\"BastionInstanceId\\": \\"rm-bp15rszyxs4t3****\\",\\n \\"HostReplacePolicy\\": \\"Auto\\",\\n \\"ZoneIDList\\": {\\n \\"ZoneIDList\\": [\\n \\"cn-hangzhou-f\\"\\n ]\\n },\\n \\"Category\\": \\"Pro\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n D6E068C3-25BC-455A-85FE-45F0B22E12SD\\n \\n 100\\n origin\\n 2021-05-07T02:00Z\\n mysql-host\\n dhg-34639v1jt4y4****\\n 0\\n 0\\n 0\\n 200\\n 100\\n 9.38\\n 0\\n 3\\n dhg-34639v1jt4y4****\\n 9.38\\n 2\\n 1\\n vpc-bp1ov7as4yvz4kxei****\\n 1024\\n 2\\n 1024\\n Evenly\\n MySQL\\n 200\\n rm-bp15rszyxs4t3****\\n Auto\\n cn-hangzhou-f\\n Pro\\n \\n","errorExample":""}]', + 'title' => '查询专属集群主机组信息', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'CreateDedicatedHost' => [ + 'summary' => '调用CreateDedicatedHost接口添加专属集群主机。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'paid', + 'abilityTreeCode' => '74472', + 'abilityTreeNodes' => [ + 'FEATUREcddcU7RCQ6', + ], + ], + 'parameters' => [ + [ + 'name' => 'DedicatedHostGroupId', + 'in' => 'query', + 'schema' => [ + 'description' => "\n" + .'目标集群ID。通过云数据库专属集群控制台**集群列表**查看目标集群ID。'."\n" + ."\n" + .'> 主机的数据库类型与集群的数据库类型一致。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'dhg-6w7q18iwt5jo****', + ], + ], + [ + 'name' => 'HostClass', + 'in' => 'query', + 'schema' => [ + 'description' => '主机的规格。关于不同数据库类型支持的主机规格，详情请参见[主机规格详情](~~206343~~)。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'rds.g6.4xlarge', + ], + ], + [ + 'name' => 'PayType', + 'in' => 'query', + 'schema' => [ + 'description' => '主机的付费类型。取值为**prepaid**（包年包月）。'."\n" + ."\n", + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'prepaid', + ], + ], + [ + 'name' => 'Period', + 'in' => 'query', + 'schema' => [ + 'description' => '指定主机的预付费类型。取值：'."\n" + ."\n" + .''."\n" + .'* **Year**：包年。'."\n" + .'* **Month**：包月。'."\n" + .'* **Week**：包周。'."\n" + ."\n" + .''."\n" + ."\n" + .''."\n" + .'* **Year**：包年。'."\n" + .'* **Month**：包月。'."\n" + ."\n" + .''."\n" + ."\n", + 'type' => 'string', + 'required' => false, + 'example' => 'Month', + ], + ], + [ + 'name' => 'UsedTime', + 'in' => 'query', + 'schema' => [ + 'description' => '指定购买时长。取值：'."\n" + ."\n" + .''."\n" + .'* 当参数**Period**=**Year**时，**UsedTime**取值为**1**~**5**。'."\n" + .'* 当参数**Period**=**Month**时，**UsedTime**取值为**1**~**9**。'."\n" + .'* 当参数**Period**=**Week**时，**UsedTime**取值为**1**、**2**、**3**。'."\n" + ."\n" + .''."\n" + ."\n" + .''."\n" + .'* 当参数**Period**=**Year**时，**UsedTime**取值为**1**~**5**。'."\n" + .'* 当参数**Period**=**Month**时，**UsedTime**取值为**1**~**9**。'."\n" + ."\n" + .''."\n" + ."\n\n", + 'type' => 'string', + 'required' => false, + 'example' => '1', + ], + ], + [ + 'name' => 'ClientToken', + 'in' => 'query', + 'schema' => [ + 'description' => '客户端生成该参数值，用于保证请求的幂等性，防止重复提交请求。该参数值只能包含ASCII字符，且不超过64个ASCII字符。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ETnLKlblzczshOTUbOCzSBZH8****', + ], + ], + [ + 'name' => 'AutoRenew', + 'in' => 'query', + 'schema' => [ + 'description' => '是否开启自动续费功能。取值：'."\n" + .'* **true**：开启。'."\n" + .'* **false**：不开启。'."\n" + ."\n" + .'> 不填写默认为**false**。', + 'type' => 'string', + 'required' => false, + 'example' => 'false', + 'default' => 'false', + ], + ], + [ + 'name' => 'ImageCategory', + 'in' => 'query', + 'schema' => [ + 'description' => '主机镜像。取值：'."\n" + .' - **WindowsWithMssqlEntAlwaysonLicense**：SQL Server集群版'."\n" + .' - **WindowsWithMssqlStdLicense**：SQL Server标准版'."\n" + .' - **WindowsWithMssqlEntLicense**：SQL Server企业版'."\n" + .' - **WindowsWithMssqlWebLicense**：SQL Server Web版'."\n" + .' - **AliLinux**：其他主机镜像'."\n" + ."\n" + .'> 创建SQL Server主机时，需要填写对应版本的主机镜像。'."\n" + ."\n\n", + 'type' => 'string', + 'required' => false, + 'example' => 'AliLinux', + ], + ], + [ + 'name' => 'OsPassword', + 'in' => 'query', + 'schema' => [ + 'description' => '主机密码。 仅集群类型为**私有部署集群**时，支持创建主机密码。密码需符合如下要求：'."\n" + .'- 长度为8~30个字符。'."\n" + .'- 必须至少包含三项：大写字母、小写字母、数字和特殊字符。'."\n" + .'- 特殊符号：()\\\\`~!@#$%^&*-_+=|{}\\[\\]:;\'<>,.?/'."\n", + 'type' => 'string', + 'required' => false, + 'example' => 'Test123456', + ], + ], + [ + 'name' => 'HostStorageType', + 'in' => 'query', + 'schema' => [ + 'description' => '主机磁盘类型，仅针对Tair类型主机生效，当前只支持以下两种类型：'."\n" + .'- **cloud_essd**：PL1云盘'."\n" + .'- **cloud_essd0**：PL0云盘', + 'type' => 'string', + 'required' => false, + 'enumValueTitles' => [ + 'cloud_essd0' => 'cloud_essd0', + 'cloud_essd' => 'cloud_essd', + ], + 'example' => 'cloud_essd0', + ], + ], + [ + 'name' => 'HostStorage', + 'in' => 'query', + 'allowEmptyValue' => false, + 'schema' => [ + 'description' => '主机磁盘大小，仅针对Tair类型主机生效，取值范围是（单位GB）：'."\n" + .'- 512'."\n" + .'- 1024'."\n" + .'- 1536'."\n" + .'- 2048'."\n" + .'- 2560'."\n" + .'- 3072'."\n" + .'- 3584'."\n" + .'- 4096', + 'type' => 'string', + 'required' => false, + 'example' => '512', + ], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所在集群的[地域ID](~~198326~~)。', + 'type' => 'string', + 'required' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'ZoneId', + 'in' => 'query', + 'schema' => [ + 'description' => '可用区ID。调用[DescribeRegions](~~214103~~)接口查询可用区ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'cn-hangzhou-i', + ], + ], + [ + 'name' => 'VSwitchId', + 'in' => 'query', + 'schema' => [ + 'description' => '虚拟交换机的ID，可通过专有网络控制台查看目标虚拟机ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'vsw-bp133c8ifzxd3iv6q****', + ], + ], + [ + 'name' => 'ClusterType', + 'in' => 'query', + 'schema' => [ + 'description' => 'MyBase 开放版使用，创建开放版集群类型：onACK、onECS', + 'type' => 'string', + 'required' => false, + 'example' => 'onACK', + ], + ], + [ + 'name' => 'ClusterAlias', + 'in' => 'query', + 'schema' => [ + 'description' => 'MyBase开放版使用，开放版集群别名', + 'type' => 'string', + 'required' => false, + 'example' => 'test-on-ack-cluster', + ], + ], + [ + 'name' => 'VpcID', + 'in' => 'query', + 'schema' => [ + 'description' => 'MyBase开放版onECS集群指定VPC ID', + 'type' => 'string', + 'required' => false, + 'example' => 'vpc-xxxxxx', + ], + ], + [ + 'name' => 'ClusterServices', + 'in' => 'query', + 'style' => 'simple', + 'schema' => [ + 'description' => 'MyBase开放版onECS实例关联的服务。', + 'type' => 'array', + 'items' => [ + 'description' => 'MyBase开放版onECS实例关联的服务。', + 'type' => 'string', + 'required' => false, + 'example' => '"Orchestrator3.2.6,Promethus2.49.1,Grafana10.2.3"', + ], + 'required' => false, + ], + ], + [ + 'name' => 'MyBaseEcsClass', + 'in' => 'query', + 'style' => 'json', + 'schema' => [ + 'description' => 'MyBase开放版onECS实例的参数。', + 'type' => 'object', + 'properties' => [ + 'ChargeType' => [ + 'description' => '付费类型，取值如下：'."\n" + .'- PrePaid：预付费。'."\n" + .'- PostPaid：后付费。', + 'type' => 'string', + 'required' => false, + 'example' => 'PrePaid', + ], + 'EcsClassCode' => [ + 'description' => '实例规格。', + 'type' => 'string', + 'required' => false, + 'example' => 'ecs.g7.large', + ], + 'Amount' => [ + 'description' => '购买数量。', + 'type' => 'integer', + 'format' => 'int64', + 'required' => false, + 'example' => '1', + ], + 'Period' => [ + 'description' => '购买on ECS主机的包年包月时长。当参数ChargeType取值为PrePaid时，Period参数必填。', + 'type' => 'integer', + 'format' => 'int64', + 'required' => false, + 'example' => '1', + ], + 'PeriodType' => [ + 'description' => '包年包月时长的单位，默认为Month（月）。', + 'type' => 'string', + 'required' => false, + 'example' => 'Month', + ], + 'SystemDiskSize' => [ + 'description' => '系统盘容量。单位为GB。', + 'type' => 'integer', + 'format' => 'int64', + 'required' => false, + 'example' => '40', + ], + 'SystemDiskCategory' => [ + 'description' => '磁盘类型。', + 'type' => 'string', + 'required' => false, + 'example' => 'cloud_essd', + ], + 'DataDiskSize' => [ + 'description' => '数据盘大小。单位为GB。', + 'type' => 'integer', + 'format' => 'int64', + 'required' => false, + 'example' => '40', + ], + 'DataDiskCategory' => [ + 'description' => '数据盘类型。', + 'type' => 'string', + 'required' => false, + 'example' => 'cloud_essd', + ], + 'DataDiskCount' => [ + 'description' => '数据盘数量。', + 'type' => 'integer', + 'format' => 'int64', + 'required' => false, + 'example' => '2', + ], + 'AutoRenew' => [ + 'description' => '是否自动续费，默认false。', + 'type' => 'boolean', + 'required' => false, + 'example' => 'false', + ], + 'Password' => [ + 'description' => 'ECS主机密码。', + 'type' => 'string', + 'required' => false, + 'example' => '***********', + ], + 'KeyPairName' => [ + 'description' => '密钥对名称。', + 'type' => 'string', + 'required' => false, + 'example' => 'test****', + ], + 'SecurityGroupIds' => [ + 'description' => '实例所属安全组集合。', + 'type' => 'array', + 'items' => [ + 'description' => '实例所属安全组。', + 'type' => 'string', + 'required' => false, + 'example' => 'sg-uf64zn0tc9qakm2j****', + ], + 'required' => false, + ], + 'Tags' => [ + 'description' => '主机标签信息。', + 'type' => 'array', + 'items' => [ + 'description' => '主机标签信息。', + 'type' => 'string', + 'required' => false, + 'example' => '{\\"key1\\":\\"value1\\"}', + ], + 'required' => false, + ], + 'InternetMaxBandwidthOut' => [ + 'description' => '公网出带宽最大值，单位为Mbit/s。'."\n" + ."\n" + .'默认值：0。设定为大于0时会自动创建公网IP。', + 'type' => 'integer', + 'format' => 'int64', + 'required' => false, + 'example' => '100', + ], + 'InternetChargeType' => [ + 'description' => '网络计费类型。取值范围：'."\n" + .'- PayByBandwidth：按固定带宽计费。'."\n" + .'- PayByTraffic：按使用流量计费。', + 'type' => 'string', + 'required' => false, + 'example' => 'PayByTraffic', + ], + 'DepolymentSetId' => [ + 'description' => '部署集ID。', + 'type' => 'string', + 'required' => false, + 'example' => '****', + ], + ], + 'required' => false, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'OrderId' => [ + 'description' => '订单ID。', + 'type' => 'integer', + 'format' => 'int64', + 'example' => '102565235', + ], + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'C860658E-68A6-46C1-AF6E-3AE7C4D32375', + ], + 'ClusterName' => [ + 'description' => '集群名称。', + 'type' => 'string', + 'example' => 'ca-2ze0x527ovq3y****', + ], + 'DedicateHostList' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'DedicateHostList' => [ + 'description' => '已创建完成的主机信息。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DedicatedHostId' => [ + 'description' => '已创建完成的主机ID。', + 'type' => 'string', + 'example' => ' ch-bp108dki3wdl6****', + ], + ], + ], + ], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'InvalidParameter', + 'errorMessage' => 'The parameter is invalid.', + ], + [ + 'errorCode' => 'COMMODITY.INVALID_COMPONENT', + 'errorMessage' => 'Invalid component.', + ], + [ + 'errorCode' => 'InvalidAccountPassword.Format', + 'errorMessage' => 'The account password format is invalid.', + ], + [ + 'errorCode' => 'InsufficientResourceCapacity', + 'errorMessage' => 'No host is available for the requested instance.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"OrderId\\": 102565235,\\n \\"RequestId\\": \\"C860658E-68A6-46C1-AF6E-3AE7C4D32375\\",\\n \\"ClusterName\\": \\"ca-2ze0x527ovq3y****\\",\\n \\"DedicateHostList\\": {\\n \\"DedicateHostList\\": [\\n {\\n \\"DedicatedHostId\\": \\" ch-bp108dki3wdl6****\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 102565235\\n C860658E-68A6-46C1-AF6E-3AE7C4D32375\\n \\n ch-bp108dki3wdl6****\\n \\n","errorExample":""}]', + 'title' => '添加专属集群主机', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'DescribeDedicatedHosts' => [ + 'summary' => '可以来查询专属集群的主机信息。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74497', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '[地域ID](~~198326~~)。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'DedicatedHostGroupId', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群ID。您可以登录云数据库专属集群控制台，在**专属集群**列表查看并获取专属集群ID。'."\n" + ."\n", + 'type' => 'string', + 'required' => false, + 'docRequired' => true, + 'example' => 'dhg-h5i4p331f509****', + ], + ], + [ + 'name' => 'OrderId', + 'in' => 'query', + 'schema' => [ + 'description' => '订单号。'."\n" + ."\n" + .'您可以前往[费用与成本](https://billing-cost.console.aliyun.com)，在左侧导航栏中选择**费用**>**订购订单**>**我的订单**，在**我的订单**查看并获取订单号。'."\n" + .'您可以前往[费用与成本](https://usercenter2-intl.aliyun.com)，在左侧导航栏中单击**订单管理**，在**订单列表**查看并获取订单号。', + 'type' => 'integer', + 'format' => 'int64', + 'required' => false, + 'example' => '123456789', + ], + ], + [ + 'name' => 'HostType', + 'in' => 'query', + 'schema' => [ + 'description' => '主机的存储类型，取值：'."\n" + .'- **dhg_local_ssd**：本地SSD盘。'."\n" + .'- **dhg_cloud_ssd**、**dhg_cloud_essd**：ESSD云盘。', + 'type' => 'string', + 'required' => false, + 'example' => 'dhg_cloud_ssd', + ], + ], + [ + 'name' => 'HostStatus', + 'in' => 'query', + 'schema' => [ + 'description' => '主机状态，取值：'."\n" + ."\n" + .'- **0**：创建中'."\n" + .'- **1**：运行中'."\n" + .'- **2**：故障中'."\n" + .'- **3**：准备下线'."\n" + .'- **4**：维护中'."\n" + .'- **5**：已下线'."\n" + .'- **6**：重启中'."\n" + .'- **7**：锁定中'."\n" + ."\n" + .'> 当主机出现故障时，主机会下线，下线过程中主机会迁移实例数据。', + 'type' => 'string', + 'required' => false, + 'example' => '1', + ], + ], + [ + 'name' => 'AllocationStatus', + 'in' => 'query', + 'schema' => [ + 'description' => '主机是否可分配实例，取值：'."\n" + .'- **Allocatable**：允许实例分配。'."\n" + .'- **Suspended**：停止实例分配。', + 'type' => 'string', + 'required' => false, + 'example' => 'Allocatable', + ], + ], + [ + 'name' => 'ZoneId', + 'in' => 'query', + 'schema' => [ + 'description' => '可用区ID。您可以调用[DescribeRegions](~~214103~~)接口获取可用区ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'ap-southeast-1a', + ], + ], + [ + 'name' => 'DedicatedHostId', + 'in' => 'query', + 'schema' => [ + 'description' => '专属集群的主机ID，您可以登录云数据库专属集群控制台，在**主机列表**查看并获取主机ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'ch-bp10a5id3boqi****', + ], + ], + [ + 'name' => 'PageNumbers', + 'in' => 'query', + 'schema' => [ + 'description' => '展示总页码数。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '50', + ], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => [ + 'description' => '每页展示数目。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '20', + ], + ], + [ + 'name' => 'Tags', + 'in' => 'query', + 'schema' => [ + 'description' => '查询绑定有该标签的主机，包括TagKey和TagValue。单次最多支持传入5组值，格式：{"key1":"value1","key2":"value2"...}。'."\n" + ."\n" + .'> 按照主机标签过滤主机信息时，不需要填写**DedicatedHostId**参数，否则会按照**DedicatedHostId**过滤主机信息。', + 'type' => 'string', + 'required' => false, + 'example' => '{"key1":"value1"}', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'TotalRecords' => [ + 'description' => '查询返回主机总数目。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '40', + ], + 'PageSize' => [ + 'description' => '每页展示数目。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '20', + ], + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22EASER', + ], + 'PageNumbers' => [ + 'description' => '展示总页码数。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '2', + ], + 'DedicatedHostGroupId' => [ + 'description' => '专属集群ID。', + 'type' => 'string', + 'example' => 'dhg-6w7q18iwt5jo****', + ], + 'DedicatedHosts' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'DedicatedHosts' => [ + 'description' => '主机信息列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'HostType' => [ + 'description' => '主机的存储类型。'."\n", + 'type' => 'string', + 'example' => 'dhg_cloud_ssd', + ], + 'HostStorage' => [ + 'description' => '主机的存储总量，单位为GB。', + 'type' => 'string', + 'example' => '1234', + ], + 'MemoryUsed' => [ + 'description' => '内存使用量，单位为GB。', + 'type' => 'string', + 'example' => '24576', + ], + 'DedicatedHostGroupId' => [ + 'description' => '主机所属专属集群ID。', + 'type' => 'string', + 'example' => 'dhg-6w7q18iwt5jo****', + ], + 'AllocationStatus' => [ + 'description' => '主机是否可分配实例，取值：'."\n" + .'- **Allocatable**：允许实例分配'."\n" + .'- **Suspended**：停止实例分配', + 'type' => 'string', + 'example' => 'Suspended', + ], + 'StorageUsed' => [ + 'description' => '存储使用量，单位为GB。', + 'type' => 'string', + 'example' => '588800', + ], + 'EcsClassCode' => [ + 'description' => 'ECS规格代码。更多信息，请参见[ECS实例规格](~~25378~~)。', + 'type' => 'string', + 'example' => 'ecs.r5.16xlarge', + ], + 'DedicatedHostId' => [ + 'description' => '主机ID。', + 'type' => 'string', + 'example' => 'ch-bp10a5id3boqi****', + ], + 'MemAllocationRatio' => [ + 'description' => '内存使用率，单位为百分比。', + 'type' => 'string', + 'example' => '90', + ], + 'CreatedTime' => [ + 'description' => '主机的创建时间，格式为**yyyy-MM-ddTHH:mm:ssZ（UTC时间）**。', + 'type' => 'string', + 'example' => '2020-10-16 16:30:19', + ], + 'IPAddress' => [ + 'description' => '主机的IP地址。', + 'type' => 'string', + 'example' => '192.168.XX.XX', + ], + 'HostStatus' => [ + 'description' => '主机状态，取值：'."\n" + ."\n" + .'- **0**：创建中'."\n" + .'- **1**：运行中'."\n" + .'- **2**：故障中'."\n" + .'- **3**：准备下线'."\n" + .'- **4**：维护中'."\n" + .'- **5**：已下线'."\n" + .'- **6**：重启中'."\n" + .'- **7**：锁定中'."\n" + ."\n" + .'> 当主机出现故障时，主机会下线，主机下线前主机会迁移实例数据到其他主机上。', + 'type' => 'string', + 'example' => '1', + ], + 'HostName' => [ + 'description' => '主机名称。', + 'type' => 'string', + 'example' => 'ch-bp15xfnp706tl****', + ], + 'HostCPU' => [ + 'description' => '主机CPU。', + 'type' => 'string', + 'example' => '16', + ], + 'CpuUsed' => [ + 'description' => 'CPU使用量，单位为核。', + 'type' => 'string', + 'example' => '10', + ], + 'InstanceNumber' => [ + 'description' => '主机上部署的实例数量。', + 'type' => 'string', + 'example' => '1', + ], + 'OpenPermission' => [ + 'description' => '主机OS权限开放状态。取值：'."\n" + ."\n" + .'- **0**：关闭'."\n" + ."\n" + .'- **1**（默认值）：开放', + 'type' => 'string', + 'example' => '1', + ], + 'DistributionSymbol' => [ + 'description' => '主机分布标识。'."\n" + ."\n" + .'> 仅主机类型为**Tair**时返回此参数。', + 'type' => 'string', + 'example' => '0', + ], + 'VPCId' => [ + 'description' => '主机所属专属集群的专有网络ID。', + 'type' => 'string', + 'example' => 'vpc-bp1roz55mrbj3ka1s****', + ], + 'HostClass' => [ + 'description' => '主机规格。', + 'type' => 'string', + 'example' => 'rds.g6.4xlarge', + ], + 'EndTime' => [ + 'description' => '主机的到期时间，格式为**yyyy-MM-ddTHH:mm:ssZ（UTC时间）**。', + 'type' => 'string', + 'example' => '2021-10-16 16:30:19', + ], + 'VSwitchId' => [ + 'description' => '主机所在虚拟交换机ID。', + 'type' => 'string', + 'example' => 'vsw-bp133c8ifzxd3iv6q****', + ], + 'ZoneId' => [ + 'description' => '主机所在可用区。', + 'type' => 'string', + 'example' => 'ap-southeast-1a', + ], + 'CPUAllocationRatio' => [ + 'description' => 'CPU使用率.。', + 'type' => 'string', + 'example' => '10', + ], + 'ImageCategory' => [ + 'description' => '主机镜像类型。', + 'type' => 'string', + 'example' => 'ALinux', + ], + 'Engine' => [ + 'description' => '主机的数据库类型。', + 'type' => 'string', + 'example' => 'mysql', + ], + 'DiskAllocationRatio' => [ + 'description' => '磁盘使用率，单位为百分比。', + 'type' => 'string', + 'example' => '10', + ], + 'HostMem' => [ + 'description' => '主机内存，单位GB。', + 'type' => 'string', + 'example' => '65536', + ], + 'BastionInstanceId' => [ + 'description' => '关联的堡垒机ID。', + 'type' => 'string', + 'example' => 'bastionhost-cn-i7m2fgw****', + ], + 'AccountName' => [ + 'description' => '自定义主机账号的名称。'."\n" + .'* 由小写字母、数字、下划线（_）组成。'."\n" + .'* 以字母开头，以字母或数字结尾。'."\n" + .'* 最少含2个字符，最多含16个字符。', + 'type' => 'string', + 'example' => 'test', + ], + 'AccountType' => [ + 'description' => '主机账号类型，取值：'."\n" + ."\n" + .'**Normal**：普通账号'."\n" + ."\n" + .'**Admin**：管理员账号', + 'type' => 'string', + 'example' => 'Normal', + ], + 'DistributionTag' => [ + 'description' => '主机分布标签。', + 'type' => 'string', + 'example' => 't4n9uz07h3r1tmcejtxf:1', + ], + 'Category' => [ + 'description' => '专属集群类型，取值：'."\n" + ."\n" + .'- **Pro**：MyBase专有版'."\n" + ."\n" + .'- **Standard**：MyBase托管版'."\n" + ."\n" + .'> 仅中国站返回此参数。'."\n", + 'type' => 'string', + 'example' => 'Standard', + ], + 'EcsId' => [ + 'description' => 'ECS ID。'."\n" + ."\n" + .'> 仅中国站且专属集群类型为**MyBase专有版**时返回此参数。'."\n" + ."\n\n" + ."\n", + 'type' => 'string', + 'example' => 'i-2zec7l031p0jtru3pn7a', + ], + 'DiskInfo' => [ + 'description' => 'ECS磁盘信息。'."\n" + ."\n" + .'> 仅中国站且专属集群类型为**MyBase专有版**时返回此参数。'."\n", + 'type' => 'string', + 'example' => '{\\"SystemDiskSize\\":20,\\"DataDiskCount\\":0,\\"DataDiskSize\\":0,\\"DataDiskCategory\\":[\\"\\"],\\"SystemDiskCategory\\":\\"cloud_essd\\"}', + ], + 'ChargeType' => [ + 'description' => '付费类型。', + 'type' => 'string', + 'example' => 'PREPAY', + ], + 'MssqlSupportVersion' => [ + 'description' => 'MyBase SQL Server主机支持的版本号。', + 'type' => 'string', + 'example' => '2012_std_ha,2012_std,2016_std_ha,2016_std,2017_std_ha,2017_std,2019_std_ha,2019_std', + ], + ], + ], + ], + ], + ], + 'MaxAutoScaleHostStorage' => [ + 'description' => '本地盘磁盘自动扩展的上限值，单位GB。', + 'type' => 'integer', + 'format' => 'int64', + 'example' => '3661824', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'Tag.InvalidTagsParameter', + 'errorMessage' => 'tags parameter is invalid', + ], + [ + 'errorCode' => 'InvalidUserId.NotSupport', + 'errorMessage' => 'The userid have no permission.', + ], + ], + 403 => [ + [ + 'errorCode' => 'Forbidden.RAM', + 'errorMessage' => 'User not authorized to operate on the specified resource, or this API does not support RAM.', + ], + ], + [ + [ + 'errorCode' => 'InvalidDedicatedHostGroup.NotFound', + 'errorMessage' => 'Specified DedicatedHostGroup does not exists.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalRecords\\": 40,\\n \\"PageSize\\": 20,\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22EASER\\",\\n \\"PageNumbers\\": 2,\\n \\"DedicatedHostGroupId\\": \\"dhg-6w7q18iwt5jo****\\",\\n \\"DedicatedHosts\\": {\\n \\"DedicatedHosts\\": [\\n {\\n \\"HostType\\": \\"dhg_cloud_ssd\\",\\n \\"HostStorage\\": \\"1234\\",\\n \\"MemoryUsed\\": \\"24576\\",\\n \\"DedicatedHostGroupId\\": \\"dhg-6w7q18iwt5jo****\\",\\n \\"AllocationStatus\\": \\"Suspended\\",\\n \\"StorageUsed\\": \\"588800\\",\\n \\"EcsClassCode\\": \\"ecs.r5.16xlarge\\",\\n \\"DedicatedHostId\\": \\"ch-bp10a5id3boqi****\\",\\n \\"MemAllocationRatio\\": \\"90\\",\\n \\"CreatedTime\\": \\"2020-10-16 16:30:19\\",\\n \\"IPAddress\\": \\"192.168.XX.XX\\",\\n \\"HostStatus\\": \\"1\\",\\n \\"HostName\\": \\"ch-bp15xfnp706tl****\\",\\n \\"HostCPU\\": \\"16\\",\\n \\"CpuUsed\\": \\"10\\",\\n \\"InstanceNumber\\": \\"1\\",\\n \\"OpenPermission\\": \\"1\\",\\n \\"DistributionSymbol\\": \\"0\\",\\n \\"VPCId\\": \\"vpc-bp1roz55mrbj3ka1s****\\",\\n \\"HostClass\\": \\"rds.g6.4xlarge\\",\\n \\"EndTime\\": \\"2021-10-16 16:30:19\\",\\n \\"VSwitchId\\": \\"vsw-bp133c8ifzxd3iv6q****\\",\\n \\"ZoneId\\": \\"ap-southeast-1a\\",\\n \\"CPUAllocationRatio\\": \\"10\\",\\n \\"ImageCategory\\": \\"ALinux\\",\\n \\"Engine\\": \\"mysql\\",\\n \\"DiskAllocationRatio\\": \\"10\\",\\n \\"HostMem\\": \\"65536\\",\\n \\"BastionInstanceId\\": \\"bastionhost-cn-i7m2fgw****\\",\\n \\"AccountName\\": \\"test\\",\\n \\"AccountType\\": \\"Normal\\",\\n \\"DistributionTag\\": \\"t4n9uz07h3r1tmcejtxf:1\\",\\n \\"Category\\": \\"Standard\\",\\n \\"EcsId\\": \\"i-2zec7l031p0jtru3pn7a\\",\\n \\"DiskInfo\\": \\"{\\\\\\\\\\\\\\"SystemDiskSize\\\\\\\\\\\\\\":20,\\\\\\\\\\\\\\"DataDiskCount\\\\\\\\\\\\\\":0,\\\\\\\\\\\\\\"DataDiskSize\\\\\\\\\\\\\\":0,\\\\\\\\\\\\\\"DataDiskCategory\\\\\\\\\\\\\\":[\\\\\\\\\\\\\\"\\\\\\\\\\\\\\"],\\\\\\\\\\\\\\"SystemDiskCategory\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"cloud_essd\\\\\\\\\\\\\\"}\\",\\n \\"ChargeType\\": \\"PREPAY\\",\\n \\"MssqlSupportVersion\\": \\"2012_std_ha,2012_std,2016_std_ha,2016_std,2017_std_ha,2017_std,2019_std_ha,2019_std\\"\\n }\\n ]\\n },\\n \\"MaxAutoScaleHostStorage\\": 3661824\\n}","errorExample":""},{"type":"xml","example":"\\n 40\\n 20\\n D6E068C3-25BC-455A-85FE-45F0B22EASER\\n 2\\n dhg-6w7q18iwt5jo****\\n \\n dhg_cloud_ssd\\n 1234\\n 24576\\n dhg-6w7q18iwt5jo****\\n Suspended\\n 588800\\n ecs.r5.16xlarge\\n ch-bp10a5id3boqi****\\n 90\\n 2020-10-16 16:30:19\\n 192.168.XX.XX\\n 1\\n ch-bp15xfnp706tl****\\n 16\\n 10\\n 1\\n 1\\n 0\\n vpc-bp1roz55mrbj3ka1s****\\n rds.g6.4xlarge\\n 2021-10-16 16:30:19\\n vsw-bp133c8ifzxd3iv6q****\\n ap-southeast-1a\\n 10\\n ALinux\\n mysql\\n 10\\n 65536\\n bastionhost-cn-i7m2fgw****\\n test\\n Normal\\n t4n9uz07h3r1tmcejtxf:1\\n Standard\\n i-2zec7l031p0jtru3pn7a\\n {\\\\\\"SystemDiskSize\\\\\\":20,\\\\\\"DataDiskCount\\\\\\":0,\\\\\\"DataDiskSize\\\\\\":0,\\\\\\"DataDiskCategory\\\\\\":[\\\\\\"\\\\\\"],\\\\\\"SystemDiskCategory\\\\\\":\\\\\\"cloud_essd\\\\\\"}\\n PREPAY\\n \\n 3661824\\n","errorExample":""}]', + 'title' => '查询专属集群的主机信息', + 'description' => '添加主机后，您可以查看主机的详细信息，包括性能监控、CPU总数、内存总量、存储总量等。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'DescribeDedicatedHostAttribute' => [ + 'summary' => '调用DescribeDedicatedHostAttribute接口查询专属集群某个主机的参数信息。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74487', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '[地域ID](~~198326~~)。', + 'type' => 'string', + 'required' => false, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'DedicatedHostId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机ID。您可以登录云数据库专属集群控制台，在**主机列表**查看并获取主机ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ch-bp10a5id3boqi****', + ], + ], + [ + 'name' => 'DedicatedHostGroupId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所属集群的ID。您可以登录云数据库专属集群控制台，在**集群列表**查看并获取专属集群ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'dhg-34639v1jt4y4****', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'HostType' => [ + 'description' => '主机的存储类型，取值：'."\n" + ."\n\n" + .'- **dhg_cloud_ssd**、**dhg_cloud_essd**：ESSD云盘'."\n" + ."\n" + .'- **dhg_local_ssd**：本地SSD盘'."\n" + ."\n", + 'type' => 'string', + 'example' => 'dhg_cloud_ssd', + ], + 'HostStorage' => [ + 'description' => '主机的存储总量，单位为GB。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '100', + ], + 'InstanceNumberROSlave' => [ + 'description' => '主机上只读实例的备节点数。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '1', + ], + 'AccountType' => [ + 'description' => '账号类型，取值：'."\n" + ."\n" + .'- **Normal**：普通权限账号'."\n" + .'- **Admin**：管理员账号', + 'type' => 'string', + 'example' => 'Admin', + ], + 'MemoryUsed' => [ + 'description' => '主机内存使用量，单位为GB。', + 'type' => 'string', + 'example' => '24576', + ], + 'DedicatedHostGroupId' => [ + 'description' => '主机所属集群的ID。', + 'type' => 'string', + 'example' => 'dhg-34639v1jt4y4****', + ], + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => '00A001D6-2630-5CBD-A23C-80BC1BAFDC31', + ], + 'InstanceNumberROMaster' => [ + 'description' => '主机上只读实例的主节点数。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '1', + ], + 'AllocationStatus' => [ + 'description' => '主机是否可分配实例，取值：'."\n" + ."\n" + .'- **Allocatable**：允许分配实例'."\n" + .'- **Suspended**：停止分配实例', + 'type' => 'string', + 'example' => 'Suspended', + ], + 'StorageUsed' => [ + 'description' => '主机的存储使用量，单位为GB。', + 'type' => 'string', + 'example' => '588800', + ], + 'EcsClassCode' => [ + 'description' => 'ECS规格代码。', + 'type' => 'string', + 'example' => 'ecs.r5.16xlarge', + ], + 'DedicatedHostId' => [ + 'description' => '主机ID。', + 'type' => 'string', + 'example' => 'ch-bp10a5id3boqi****', + ], + 'MemAllocationRatio' => [ + 'description' => '内存使用率，单位为百分比。', + 'type' => 'string', + 'example' => '90', + ], + 'CreatedTime' => [ + 'description' => '主机创建成功的时间，格式为**yyyy-MM-ddTHH:mm:ssZ（UTC时间）**。', + 'type' => 'string', + 'example' => '2021-11-13T07:14:22Z', + ], + 'IPAddress' => [ + 'description' => '主机的IP地址。', + 'type' => 'string', + 'example' => '192.168.XX.XX', + ], + 'AutoRenew' => [ + 'description' => '是否开启自动续费功能，取值：'."\n" + .'* **true**：开启'."\n" + .'* **false**（默认值）：不开启'."\n", + 'type' => 'string', + 'example' => 'false', + ], + 'HostStatus' => [ + 'description' => '主机状态，取值：'."\n" + ."\n" + .'- **0**：创建中'."\n" + .'- **1**：运行中'."\n" + .'- **2**：故障中'."\n" + .'- **3**：准备下线'."\n" + .'- **4**：维护中'."\n" + .'- **5**：已下线'."\n" + .'- **6**：重启中'."\n" + .'- **7**：锁定中'."\n" + ."\n" + .'> 当主机出现故障时，主机要下线，主机下线之前会将该故障主机上的实例进行迁移，从而保证数据的完整性。', + 'type' => 'string', + 'example' => '1', + ], + 'HostName' => [ + 'description' => '主机的名称。', + 'type' => 'string', + 'example' => 'ch-8vbj9x74z874o****', + ], + 'HostCPU' => [ + 'description' => '主机的CPU，单位为核。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '16', + ], + 'OpenPermission' => [ + 'description' => '是否开放专属集群内的主机的OS权限，取值：'."\n" + ."\n" + .'- **0**：不可开放状态'."\n" + .'- **1**：开放状态', + 'type' => 'string', + 'example' => '1', + ], + 'InstanceNumber' => [ + 'description' => '主机上部署实例的个数。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '3', + ], + 'CpuUsed' => [ + 'description' => '主机CPU使用量。', + 'type' => 'string', + 'example' => '36', + ], + 'VPCId' => [ + 'description' => '专有网络的ID。', + 'type' => 'string', + 'example' => 'vpc-wz9vu1jb32wn3sdd6****', + ], + 'HostClass' => [ + 'description' => '主机的规格。', + 'type' => 'string', + 'example' => 'mssql.host.c2xlarge', + ], + 'RegionId' => [ + 'description' => '[地域ID](~~198326~~)。', + 'type' => 'string', + 'example' => 'cn-hangzhou', + ], + 'InstanceNumberMaster' => [ + 'description' => '主机上的主节点数。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '4', + ], + 'VSwitchId' => [ + 'description' => 'VSwitch ID。', + 'type' => 'string', + 'example' => 'vsw-bp1kaugqyrzb58oc1****', + ], + 'InstanceNumberSlave' => [ + 'description' => '主机上的备节点数。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '1', + ], + 'ExpiredTime' => [ + 'description' => '主机到期时间，格式为**yyyy-MM-ddTHH:mm:ssZ（UTC时间）**。', + 'type' => 'string', + 'example' => '2022-03-16T16:00:00Z', + ], + 'ZoneId' => [ + 'description' => '可用区ID。', + 'type' => 'string', + 'example' => 'cn-hangzhou-h', + ], + 'CPUAllocationRatio' => [ + 'description' => '专属集群的cpu超配比，单位为百分比，精确到10%。', + 'type' => 'string', + 'example' => '200', + ], + 'ImageCategory' => [ + 'description' => '主机镜像。引擎类型为**SQL Server**时返回，取值：'."\n" + ."\n" + .'- **WindowsWithMssqlEntAlwaysonLicense**：SQL Server集群版'."\n" + ."\n" + .'- **WindowsWithMssqlStdLicense**：SQL Server标准版'."\n" + ."\n" + .'- **WindowsWithMssqlEntLicense**：SQL Server企业版'."\n" + ."\n" + .'- **WindowsWithMssqlWebLicense**：SQL Server Web版', + 'type' => 'string', + 'example' => 'WindowsWithMssqlStdLicense', + ], + 'DiskAllocationRatio' => [ + 'description' => '专属集群的空间超配比。'."\n" + ."\n", + 'type' => 'string', + 'example' => '200', + ], + 'HostMem' => [ + 'description' => '主机的内存，单位为MB。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '2048', + ], + 'AccountName' => [ + 'description' => '主机账号名称。'."\n" + ."\n" + .'- 由小写字母、数字、下划线（_）组成。'."\n" + ."\n" + .'- 以字母开头，以字母或数字结尾。'."\n" + ."\n" + .'- 包含2~16个字符。', + 'type' => 'string', + 'example' => 'cdp_system', + ], + 'DistributionTag' => [ + 'description' => '主机分布的标签。', + 'type' => 'string', + 'example' => 'tag', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'InvalidUserId.NotSupport', + 'errorMessage' => 'The userid have no permission.', + ], + ], + 403 => [ + [ + 'errorCode' => 'Forbidden.RAM', + 'errorMessage' => 'User not authorized to operate on the specified resource, or this API does not support RAM.', + ], + [ + 'errorCode' => 'Permission.NotSupport', + 'errorMessage' => 'The user permission does not support the operation.', + ], + ], + [ + [ + 'errorCode' => 'InvalidDedicatedHostGroup.NotFound', + 'errorMessage' => 'Specified DedicatedHostGroup does not exists.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"HostType\\": \\"dhg_cloud_ssd\\",\\n \\"HostStorage\\": 100,\\n \\"InstanceNumberROSlave\\": 1,\\n \\"AccountType\\": \\"Admin\\",\\n \\"MemoryUsed\\": \\"24576\\",\\n \\"DedicatedHostGroupId\\": \\"dhg-34639v1jt4y4****\\",\\n \\"RequestId\\": \\"00A001D6-2630-5CBD-A23C-80BC1BAFDC31\\",\\n \\"InstanceNumberROMaster\\": 1,\\n \\"AllocationStatus\\": \\"Suspended\\",\\n \\"StorageUsed\\": \\"588800\\",\\n \\"EcsClassCode\\": \\"ecs.r5.16xlarge\\",\\n \\"DedicatedHostId\\": \\"ch-bp10a5id3boqi****\\",\\n \\"MemAllocationRatio\\": \\"90\\",\\n \\"CreatedTime\\": \\"2021-11-13T07:14:22Z\\",\\n \\"IPAddress\\": \\"192.168.XX.XX\\",\\n \\"AutoRenew\\": \\"false\\",\\n \\"HostStatus\\": \\"1\\",\\n \\"HostName\\": \\"ch-8vbj9x74z874o****\\",\\n \\"HostCPU\\": 16,\\n \\"OpenPermission\\": \\"1\\",\\n \\"InstanceNumber\\": 3,\\n \\"CpuUsed\\": \\"36\\",\\n \\"VPCId\\": \\"vpc-wz9vu1jb32wn3sdd6****\\",\\n \\"HostClass\\": \\"mssql.host.c2xlarge\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"InstanceNumberMaster\\": 4,\\n \\"VSwitchId\\": \\"vsw-bp1kaugqyrzb58oc1****\\",\\n \\"InstanceNumberSlave\\": 1,\\n \\"ExpiredTime\\": \\"2022-03-16T16:00:00Z\\",\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"CPUAllocationRatio\\": \\"200\\",\\n \\"ImageCategory\\": \\"WindowsWithMssqlStdLicense\\",\\n \\"DiskAllocationRatio\\": \\"200\\",\\n \\"HostMem\\": 2048,\\n \\"AccountName\\": \\"cdp_system\\",\\n \\"DistributionTag\\": \\"tag\\"\\n}","errorExample":""},{"type":"xml","example":"\\n dhg_cloud_ssd\\n 100\\n 1\\n Admin\\n 24576\\n dhg-34639v1jt4y4****\\n 00A001D6-2630-5CBD-A23C-80BC1BAFDC31\\n 1\\n Suspended\\n 588800\\n ecs.r5.16xlarge\\n ch-bp10a5id3boqi****\\n 90\\n 2021-11-13T07:14:22Z\\n 192.168.XX.XX\\n false\\n 1\\n ch-8vbj9x74z874o****\\n 16\\n 1\\n 3\\n 36\\n vpc-wz9vu1jb32wn3sdd6****\\n mssql.host.c2xlarge\\n cn-hangzhou\\n 4\\n vsw-bp1kaugqyrzb58oc1****\\n 1\\n 2022-03-16T16:00:00Z\\n cn-hangzhou-h\\n 200\\n WindowsWithMssqlStdLicense\\n 200\\n 2048\\n cdp_system\\n tag\\n","errorExample":""}]', + 'title' => '查询专属集群某个主机的参数信息', + ], + 'DescribeHostEcsLevelInfo' => [ + 'summary' => '调用DescribeHostEcsLevelInfo查询主机规格详细信息。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74507', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'DbType', + 'in' => 'query', + 'schema' => [ + 'description' => '数据库引擎类型，取值：'."\n" + ."\n" + .'- **mysql**'."\n" + .'- **mssql**'."\n" + .'- **pgsql**'."\n" + .'- **redis**', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'mysql', + ], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'ZoneId', + 'in' => 'query', + 'schema' => [ + 'description' => '地域下的可用区ID。', + 'type' => 'string', + 'required' => true, + 'example' => 'ap-southeast-1a', + ], + ], + [ + 'name' => 'StorageType', + 'in' => 'query', + 'schema' => [ + 'description' => '实例存储类型，取值：'."\n" + ."\n" + .'- **local_ssd**：SSD云盘'."\n" + .'- **cloud_essd**：ESSD PL1云盘'."\n" + .'- **cloud_essd2**：ESSD PL2云盘'."\n" + .'- **cloud_essd3**：ESSD PL3云盘', + 'type' => 'string', + 'required' => true, + 'example' => 'local_ssd', + ], + ], + [ + 'name' => 'ImageCategory', + 'in' => 'query', + 'schema' => [ + 'description' => '主机镜像。取值：'."\n" + ."\n" + .'- **WindowsWithMssqlEntAlwaysonLicense**：SQL Server集群版'."\n" + ."\n" + .'- **WindowsWithMssqlStdLicense**：SQL Server标准版'."\n" + ."\n" + .'- **WindowsWithMssqlEntLicense**：SQL Server企业版'."\n" + ."\n" + .'- **WindowsWithMssqlWebLicense**：SQL Server Web版'."\n" + ."\n" + .'- **AliLinux**：其他主机镜像。', + 'type' => 'string', + 'required' => false, + 'example' => 'AliLinux', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => '395858E2-2A82-4ED7-BB93-2DB60119EF4C', + ], + 'HostEcsLevelInfos' => [ + 'description' => 'ECS主机信息列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'CddcHostType' => [ + 'description' => '主机类型 ，取值：'."\n" + ."\n" + .'- **general**: 通用型。'."\n" + .'- **compute**: 计算型。'."\n" + .'- **ram**: 内存型。'."\n" + .'- **dragon**: 弹性裸金属服务器（神龙）。', + 'type' => 'string', + 'example' => 'ram', + ], + 'Items' => [ + 'description' => '主机规格详情。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'NetBandWidth' => [ + 'description' => '内网带宽，单位为Gbps。'."\n" + ."\n", + 'type' => 'number', + 'format' => 'float', + 'example' => '10', + ], + 'EcsClass' => [ + 'description' => '规格族。', + 'type' => 'string', + 'example' => '通用型 g6', + ], + 'RdsClassCode' => [ + 'description' => 'RDS规格。'."\n" + ."\n", + 'type' => 'string', + 'example' => 'mssql.cluster.host.g2xlarge ', + ], + 'Cpu' => [ + 'description' => '主机CPU。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '24', + ], + 'CpuFrequency' => [ + 'description' => '处理器频率，单位为GHz。', + 'type' => 'string', + 'example' => '2.5 GHz/3.2 GHz', + ], + 'StorageIops' => [ + 'description' => '存储IOPS ，单位为万。'."\n" + ."\n", + 'type' => 'integer', + 'format' => 'int32', + 'example' => '5', + ], + 'CloudStorageBandwidth' => [ + 'description' => '云盘带宽，单位为Gbit/s。', + 'type' => 'number', + 'format' => 'float', + 'example' => '4', + ], + 'EcsClassCode' => [ + 'description' => 'ECS规格。'."\n" + ."\n", + 'type' => 'string', + 'example' => 'ecs.g6.2xlarge ', + ], + 'IsCloudDisk' => [ + 'description' => '是否为云盘。'."\n" + ."\n", + 'type' => 'integer', + 'format' => 'int32', + 'example' => '1', + ], + 'Memory' => [ + 'description' => '内存大小，单位为GB。'."\n" + ."\n", + 'type' => 'integer', + 'format' => 'int32', + 'example' => '192', + ], + 'NetPackage' => [ + 'description' => '内网收发包，单位为万PPS。'."\n" + ."\n", + 'type' => 'integer', + 'format' => 'int32', + 'example' => '150', + ], + 'CpuVersion' => [ + 'description' => '处理器型号。', + 'type' => 'string', + 'example' => 'Intel Xeon(Cascade Lake) Platinum 8269CY ', + ], + 'LocalStorage' => [ + 'description' => '本地存储。'."\n" + ."\n", + 'type' => 'string', + 'example' => '7', + ], + 'Description' => [ + 'description' => '主机的名称。', + 'type' => 'string', + 'example' => 'testxxx', + ], + ], + ], + ], + ], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'InvalidAction', + 'errorMessage' => 'The specified action is not valid.', + ], + ], + 403 => [ + [ + 'errorCode' => 'Permission.NotSupport', + 'errorMessage' => 'You are not authorized to perform this action.', + ], + [ + 'errorCode' => 'Forbidden.RAM', + 'errorMessage' => 'User not authorized to operate on the specified resource, or this API does not support RAM.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"395858E2-2A82-4ED7-BB93-2DB60119EF4C\\",\\n \\"HostEcsLevelInfos\\": [\\n {\\n \\"CddcHostType\\": \\"ram\\",\\n \\"Items\\": [\\n {\\n \\"NetBandWidth\\": 10,\\n \\"EcsClass\\": \\"通用型 g6\\",\\n \\"RdsClassCode\\": \\"mssql.cluster.host.g2xlarge\\\\t\\",\\n \\"Cpu\\": 24,\\n \\"CpuFrequency\\": \\"2.5 GHz/3.2 GHz\\",\\n \\"StorageIops\\": 5,\\n \\"CloudStorageBandwidth\\": 4,\\n \\"EcsClassCode\\": \\"ecs.g6.2xlarge\\\\t\\",\\n \\"IsCloudDisk\\": 1,\\n \\"Memory\\": 192,\\n \\"NetPackage\\": 150,\\n \\"CpuVersion\\": \\"Intel Xeon(Cascade Lake) Platinum 8269CY\\\\t\\",\\n \\"LocalStorage\\": \\"7\\",\\n \\"Description\\": \\"testxxx\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n395858E2-2A82-4ED7-BB93-2DB60119EF4C\\n\\n ram\\n \\n testxxx\\n 192\\n 24\\n 150\\n 4\\n Intel Xeon(Cascade Lake) Platinum 8269CY\\t\\n 1\\n 10\\n 7\\n 5\\n mssql.cluster.host.g2xlarge\\t\\n ecs.g6.2xlarge\\t\\n 2.5 GHz/3.2 GHz\\n 通用型 g6\\t\\n \\n\\n","errorExample":""}]', + 'title' => '查询主机规格详细信息', + 'description' => '添加主机后，您可以查看主机规格的详细信息，包括CPU、内存、处理器型号、主机类型、主机存储类型等。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'DescribeDedicatedHostDisks' => [ + 'summary' => '调用DescribeDedicatedHostDisks接口查询主机上的磁盘信息。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '76548', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'DedicatedHostId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机ID。您可以登录云数据库专属集群控制台，在**主机列表**查看并获取主机ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ch-bp183v72jr033****', + ], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所在的地域ID。您可以登录云数据库专属集群控制台，查看主机所在[地域信息](~~198326~~)。', + 'type' => 'string', + 'required' => false, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'DedicatedHostId' => [ + 'description' => '主机ID。', + 'type' => 'string', + 'example' => 'ch-bp183v72jr033****', + ], + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'C6C6CF41-F284-4F63-AB4D-44FACE3BASQW', + ], + 'Disks' => [ + 'description' => '磁盘信息。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Type' => [ + 'description' => '云盘或本地盘磁盘类型 ，取值：'."\n" + ."\n" + .'- **system**：系统盘'."\n" + ."\n" + .'- **data**： 数据盘'."\n", + 'type' => 'string', + 'example' => 'data', + ], + 'Status' => [ + 'description' => '云盘状态，取值：'."\n" + ."\n" + .'- **In_use**'."\n" + ."\n" + .'- **Available**'."\n" + ."\n" + .'- **Attaching**'."\n" + ."\n" + .'- **Detaching**'."\n" + ."\n" + .'- **Creating**'."\n" + ."\n" + .'- **ReIniting**'."\n", + 'type' => 'string', + 'example' => 'In_use', + ], + 'PerformanceLevel' => [ + 'description' => '磁盘性能。 '."\n" + ."\n" + .'> MyBase提供了**ESSD云盘**、**ESSD PL2云盘**、**ESSD PL3云盘**三个性能级别的云盘规格，PL级别越高，云盘性能越好。'."\n", + 'type' => 'string', + 'example' => 'PL1', + ], + 'DiskId' => [ + 'description' => '云盘或本地盘ID。', + 'type' => 'string', + 'example' => 'd-bp1dffpog8r2eowd****', + ], + 'MaxThroughput' => [ + 'description' => '磁盘最大吞吐量，单位为MB/S。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '284', + ], + 'MaxIOPS' => [ + 'description' => '磁盘最大IOPS，单位为万。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '18250', + ], + 'HasDBInstance' => [ + 'description' => '是否有实例运行在该磁盘上，取值：'."\n" + .'- **true**：有运行的实例'."\n" + .'- **false**：无运行的实例', + 'type' => 'boolean', + 'example' => 'true', + ], + 'Device' => [ + 'description' => '云盘或本地盘挂载实例的设备名。', + 'type' => 'string', + 'example' => '/dev/xvdb', + ], + 'Size' => [ + 'description' => '云盘或本地盘大小，单位为GB。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '329', + ], + 'ZoneId' => [ + 'description' => '云盘或本地盘所属的可用区ID。', + 'type' => 'string', + 'example' => 'cn-hangzhou-h', + ], + 'Category' => [ + 'description' => '主机存储类型，取值：'."\n" + .'- **cloud_ssd**：本地SSD盘'."\n" + .'- **cloud_essd**：ESSD云盘'."\n" + ."\n\n", + 'type' => 'string', + 'example' => 'cloud_essd', + ], + 'DBInstanceId' => [ + 'description' => '该磁盘上运行的实例ID。'."\n" + ."\n", + 'type' => 'string', + 'example' => 'rm-bp121zcqr5h8m****', + ], + ], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'InvalidUserId.NotSupport', + 'errorMessage' => 'The user ID has no permission.', + ], + ], + 404 => [ + [ + 'errorCode' => 'HostInfo.NotFound', + 'errorMessage' => 'The specified host info is not found.', + ], + [ + 'errorCode' => 'InvalidDedicatedHostGroup.NotFound', + 'errorMessage' => 'The specified DedicatedHostGroup does not exist.', + ], + [ + 'errorCode' => 'InvalidParameter', + 'errorMessage' => 'The parameter is invalid.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"DedicatedHostId\\": \\"ch-bp183v72jr033****\\",\\n \\"RequestId\\": \\"C6C6CF41-F284-4F63-AB4D-44FACE3BASQW\\",\\n \\"Disks\\": [\\n {\\n \\"Type\\": \\"data\\",\\n \\"Status\\": \\"In_use\\",\\n \\"PerformanceLevel\\": \\"PL1\\",\\n \\"DiskId\\": \\"d-bp1dffpog8r2eowd****\\",\\n \\"MaxThroughput\\": 284,\\n \\"MaxIOPS\\": 18250,\\n \\"HasDBInstance\\": true,\\n \\"Device\\": \\"/dev/xvdb\\",\\n \\"Size\\": 329,\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"Category\\": \\"cloud_essd\\",\\n \\"DBInstanceId\\": \\"rm-bp121zcqr5h8m****\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\nch-bp183v72jr033****\\nC6C6CF41-F284-4F63-AB4D-44FACE3BASQW\\n\\n In_use\\n true\\n \\n data\\n cloud\\n cn-hangzhou-h\\n rm-bp121zcqr5h8m****\\n 329\\n /dev/xvdb\\n PL1\\n 18250\\n d-bp1dffpog8r2eowd****\\n\\n","errorExample":""}]', + 'title' => '查询主机上的磁盘信息', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'ModifyDedicatedHostAttribute' => [ + 'summary' => '调用ModifyDedicatedHostAttribute接口设置专属集群的主机是否允许分配实例。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74526', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所在[地域ID](~~198326~~)。', + 'type' => 'string', + 'required' => false, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'DedicatedHostId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机ID。您可以登录云数据库专属集群控制台，在**主机列表**查看并获取主机ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ch-bp10a5id3boqi****', + ], + ], + [ + 'name' => 'HostName', + 'in' => 'query', + 'schema' => [ + 'description' => '主机名称。', + 'type' => 'string', + 'required' => false, + 'example' => 'mysql-host', + ], + ], + [ + 'name' => 'AllocationStatus', + 'in' => 'query', + 'schema' => [ + 'description' => '主机是否可分配实例，取值：'."\n" + .'- **1**：允许实例分配。'."\n" + .'- **0**：停止实例分配。', + 'type' => 'string', + 'required' => false, + 'example' => '1', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22ESFS', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'InvalidUserId.NotSupport', + 'errorMessage' => 'The userid have no permission.', + ], + [ + 'errorCode' => 'ParamTypeException', + 'errorMessage' => 'The parameter\'s type error.', + ], + ], + 404 => [ + [ + 'errorCode' => 'HostInfo.NotFound', + 'errorMessage' => 'Specified hostinfo is not found.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22ESFS\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\nD6E068C3-25BC-455A-85FE-45F0B22ESFS\\r\\n","errorExample":""}]', + 'title' => '设置专属集群的主机是否允许分配实例', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'ReplaceDedicatedHost' => [ + 'summary' => '调用ReplaceDedicatedHost接口替换专属集群的主机。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74535', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '目标主机所在地域ID。可调用[DescribeDedicatedHostAttribute](~~213010~~)获取。', + 'type' => 'string', + 'required' => false, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'DedicatedHostId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机ID。可调用[DescribeDedicatedHosts](~~200944~~)获取目标主机ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ch-bp10a5id3boqi****', + ], + ], + [ + 'name' => 'FailoverMode', + 'in' => 'query', + 'schema' => [ + 'description' => '实例主库的切换方案。取值：'."\n" + .'- **MaintainTime**（默认）：在实例维护时间段切换，等待当前主机上的主实例都切换成其他主机的备实例后再重启主机，避免影响业务。'."\n" + .'- **Immediate**：立即强制重启主机。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'MaintainTime', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'DedicatedHostId' => [ + 'description' => '专属集群的主机ID。', + 'type' => 'string', + 'example' => ' ch-bp10a5id3boqi****', + ], + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22EDSD8', + ], + 'TaskId' => [ + 'description' => '任务ID。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '10254125', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 404 => [ + [ + 'errorCode' => 'InvalidDedicatedHostId_NotFound', + 'errorMessage' => 'specific DedicatedHostId not found', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"DedicatedHostId\\": \\" ch-bp10a5id3boqi****\\",\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22EDSD8\\",\\n \\"TaskId\\": 10254125\\n}","errorExample":""},{"type":"xml","example":"\\n dhg-6w7q18iwt5jo****\\n10254125\\nD6E068C3-25BC-455A-85FE-45F0B22EDSD8\\n","errorExample":""}]', + 'title' => '替换专属集群的主机', + 'description' => '当MySQL主机故障策略选择手动替换，且MySQL主机状态为**故障中**时，您可调用该接口替换主机。'."\n" + ."\n" + .'> 您可通过调用[DescribeDedicatedHostAttribute](~~213010~~)接口，根据返回参数**HostStatus**的值获取当前主机的状态。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'RestartDedicatedHost' => [ + 'summary' => '调用RestartDedicatedHost接口重启专属集群的主机。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74537', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所在的[地域ID](~~198326~~)。', + 'type' => 'string', + 'required' => false, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'DedicatedHostId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机ID。您可以登录云数据库专属集群控制台，在**主机列表**查看并获取主机ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ch-bp10a5id3boqi****', + ], + ], + [ + 'name' => 'FailoverMode', + 'in' => 'query', + 'schema' => [ + 'description' => '主实例的切换方案，取值：'."\n" + .'- **MaintainTime**（默认）：在实例维护时间段切换，等待当前主机上的主实例切换到其他主机的备实例后再重启主机，避免影响业务。'."\n" + .'- **Immediate**：立即切换，即立即强制重启主机。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'MaintainTime', + ], + ], + [ + 'name' => 'ForceStop', + 'in' => 'query', + 'schema' => [ + 'description' => '是否强制关机重启，取值：'."\n" + ."\n" + .'- true：强制重启。执行断电操作，所有未写入存储设备的缓存数据会丢失，请谨慎选择。'."\n" + ."\n" + .'- false（默认值）：正常重启。'."\n" + ."\n" + .'> 该参数仅对Tair主机生效，其余引擎主机重启均为正常重启。', + 'type' => 'boolean', + 'required' => false, + 'example' => 'false', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'DedicatedHostId' => [ + 'description' => '主机ID。', + 'type' => 'string', + 'example' => 'ch-bp10a5id3boqi****', + ], + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22EDSH', + ], + 'TaskId' => [ + 'description' => '任务ID。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '10254125', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'InvalidUserId.NotSupport', + 'errorMessage' => 'The userid have no permission.', + ], + ], + 403 => [ + [ + 'errorCode' => 'InvalidAction.NotSupport', + 'errorMessage' => 'The host status does not support the operation.', + ], + ], + [ + [ + 'errorCode' => 'HostInfo.NotFound', + 'errorMessage' => 'Specified hostinfo is not found.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"DedicatedHostId\\": \\"ch-bp10a5id3boqi****\\",\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22EDSH\\",\\n \\"TaskId\\": 10254125\\n}","errorExample":""},{"type":"xml","example":"\\nch-bp10a5id3boqi****\\n10254125\\nD6E068C3-25BC-455A-85FE-45F0B22EDSH\\n","errorExample":""}]', + 'title' => '重启专属集群的主机', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'DescribeHostWebShell' => [ + 'summary' => '调用DescribeHostWebShell接口获取专属集群主机Webshell登录地址。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '76551', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'DedicatedHostId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机ID。可调用[DescribeDedicatedHosts](~~200944~~)获取。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ch-bp10a5id3boqi****', + ], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所在地域ID。可调用[DescribeDedicatedHostAttribute](~~213010~~)获取。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'ZoneId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所在可用区ID。可调用[DescribeDedicatedHostAttribute](~~213010~~)获取。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'cn-hangzhou-b', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'LoginUrl' => [ + 'description' => 'Webshell登录地址。', + 'type' => 'string', + 'example' => 'https://ecs-workbench-disposable.aliyun.com/account/disposable/login/sst/mybase.c7dfa64e9f/m44kih****', + ], + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22ESTG2', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'InvalidUserId.NotSupport', + 'errorMessage' => 'The user ID has no permission.', + ], + ], + 403 => [ + [ + 'errorCode' => 'InvalidInstance', + 'errorMessage' => 'The instance does not support the operation.', + ], + ], + [ + [ + 'errorCode' => 'HostInfo.NotFound', + 'errorMessage' => 'The specified host info is not found.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"LoginUrl\\": \\"https://ecs-workbench-disposable.aliyun.com/account/disposable/login/sst/mybase.c7dfa64e9f/m44kih****\\",\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22ESTG2\\"\\n}","errorExample":""},{"type":"xml","example":"\\nD6E068C3-25BC-455A-85FE-45F0B22ESTG2\\nhttps://ecs-workbench-disposable.aliyun.com/account/disposable/login/sst/mybase.c7dfa64e9f/m44kih****\\n","errorExample":""}]', + 'title' => '获取专属集群主机 Webshell 登录地址', + 'description' => '专属集群MySQL、PostgreSQL类型的数据库引擎支持通过Webshell访问主机。具体详情请参见[通过Webshell访问主机](~~205456~~)。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'ModifyDedicatedHostClass' => [ + 'summary' => '调用ModifyDedicatedHostClass接口升配主机的规格。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '76557', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '[地域ID](~~198326~~)。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'DedicatedHostId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机ID。您可以登录云数据库专属集群控制台，在**主机列表**查看并获取主机ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ch-bp1fgj3kt7fsb****', + ], + ], + [ + 'name' => 'TargetClassCode', + 'in' => 'query', + 'schema' => [ + 'description' => '主机升配的规格编码，详情请参见[主机规格详情](~~206343~~)。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'rds.c6.x4large', + ], + ], + [ + 'name' => 'SwitchTime', + 'in' => 'query', + 'schema' => [ + 'description' => '指定主机规格的升配时间，格式为yyyy-MM-ddTHH:mm:ssZ（UTC时间）。'."\n" + .'>仅当SwitchTimeMode为2时，需要传入SwitchTime参数。'."\n", + 'type' => 'string', + 'required' => false, + 'docRequired' => false, + 'example' => '2021-07-13T07:14:22Z', + ], + ], + [ + 'name' => 'SwitchTimeMode', + 'in' => 'query', + 'schema' => [ + 'description' => '选择升配的执行模式，取值：'."\n" + .'- **0**（默认）：立刻执行升配。'."\n" + ."\n" + .'- **2**：在指定时间执行升配。'."\n" + ."\n" + .'> 若本参数的值为**2**，则必须同时传入**SwitchTime**参数。', + 'type' => 'string', + 'required' => false, + 'example' => '2', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'DedicatedHostId' => [ + 'description' => '主机ID。', + 'type' => 'string', + 'example' => 'ch-bp1fgj3kt7fsb****', + ], + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22ESD12', + ], + 'TaskId' => [ + 'description' => '任务ID。', + 'type' => 'string', + 'example' => '10254125', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'InvalidAction', + 'errorMessage' => 'The specified action is not valid.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"DedicatedHostId\\": \\"ch-bp1fgj3kt7fsb****\\",\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22ESD12\\",\\n \\"TaskId\\": \\"10254125\\"\\n}","errorExample":""},{"type":"xml","example":"\\nch-bp1fgj3kt7fsb****\\n10254125\\nD6E068C3-25BC-455A-85FE-45F0B22ESD12\\n","errorExample":""}]', + 'title' => '升配主机的规格', + 'description' => '在创建专属集群MyBase主机后，如果当前主机规格配置无法满足您的业务需求，您可随时变更主机的规格，包括主机的CPU、内存等，更多信息请参见[升配主机规格](~~262822~~)。'."\n" + .'> 主机升配会导致主机重启（主机上运行数据库实例也随之重启），关于重启主机对数据库实例产生影响，详情请参见[重启主机](~~141772~~)。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'TagResources' => [ + 'summary' => '为一个或多个主机绑定标签。', + 'methods' => [ + 'get', + 'post', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '94226', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所属的地域ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ap-southeast-1', + ], + ], + [ + 'name' => 'ResourceId', + 'in' => 'query', + 'style' => 'repeatList', + 'schema' => [ + 'description' => '主机ID，可以设置多个。'."\n" + ."\n", + 'type' => 'array', + 'items' => [ + 'description' => '主机ID，可以设置多个。'."\n" + .' **N**表示传入第几个主机ID。例如：'."\n" + .'- **Resourceid.1**表示传入第一个主机ID。'."\n" + .'- **Resourceid.2**表示传入第二个主机ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'ch-bp1yp3mqggn8****', + ], + 'required' => true, + 'example' => 'ch-t4n4dcdvu6840****', + 'maxItems' => 51, + ], + ], + [ + 'name' => 'Tag', + 'in' => 'query', + 'style' => 'repeatList', + 'schema' => [ + 'description' => '标签', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Key' => [ + 'description' => '标签的键。'."\n" + ."\n" + .'- **N**表示传入第几个标签的键。例如：'."\n" + ."\n" + .' - **Tag.1.Key**表示传入第一个标签的键。'."\n" + ."\n" + .' - **Tag.2.Key**表示传入第二个标签的键。'."\n" + .'- 如果标签的键不存在，则自动创建。', + 'type' => 'string', + 'required' => true, + 'example' => 'demokey', + ], + 'Value' => [ + 'description' => '标签的值。'."\n" + ."\n" + .'- **N**表示传入第几个标签的值。例如：'."\n" + ."\n" + .' - **Tag.1.Value**表示传入第一个标签的值。'."\n" + ."\n" + .' - **Tag.2.Value**表示传入第二个标签的值。'."\n" + .'- 如果标签的值不存在，则自动创建。', + 'type' => 'string', + 'required' => true, + 'example' => 'demovalue', + ], + ], + 'required' => false, + ], + 'required' => true, + 'maxItems' => 21, + ], + ], + [ + 'name' => 'ResourceType', + 'in' => 'query', + 'schema' => [ + 'description' => '资源类型，取值固定为DEDICATEDHOST。'."\n" + ."\n", + 'type' => 'string', + 'required' => true, + 'example' => 'DEDICATEDHOST', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => '4B938011-874B-5F54-8B9E-7E2A08B3AA13', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'OperationDenied.QuotaExceed', + 'errorMessage' => 'The Tags parameter number is exceed. Valid is 20.', + ], + [ + 'errorCode' => 'NoPermission.SystemTag', + 'errorMessage' => 'The operator is not permission for the system tag', + ], + [ + 'errorCode' => 'InvalidParameter.TagValue', + 'errorMessage' => 'The Tag.%s.Value parameter - %s is invalid', + ], + [ + 'errorCode' => 'InvalidParameter.TagKey', + 'errorMessage' => 'The Tag.%s.Key parameter - %s is invalid', + ], + [ + 'errorCode' => 'NumberExceed.ResourceIds', + 'errorMessage' => 'The ResourceIds parameter\'s number is exceed , Valid : 50', + ], + [ + 'errorCode' => 'InvalidTagValue.Malformed', + 'errorMessage' => 'The specified parameter "Tag.n.Value" is not valid.', + ], + [ + 'errorCode' => 'InvalidDedicatedHostId.NotFound', + 'errorMessage' => 'The parameter - ResourceIds.N is not found.', + ], + [ + 'errorCode' => 'InvalidParameter.ResourceType', + 'errorMessage' => 'The specified parameter "ResourceType" is not valid.', + ], + [ + 'errorCode' => 'NumberExceed.Tags', + 'errorMessage' => 'The Tags parameter\'s number is exceed, Valid : 20.', + ], + [ + 'errorCode' => 'MissingParameter.ResourceIds', + 'errorMessage' => 'The parameter - ResourceIds.N should not be null.', + ], + [ + 'errorCode' => 'Duplicate.TagKey', + 'errorMessage' => 'The Tag.N.Key contain duplicate key.', + ], + [ + 'errorCode' => 'InvalidTagKey.Malformed', + 'errorMessage' => 'The Tag.N.Key parameter is invalid.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"4B938011-874B-5F54-8B9E-7E2A08B3AA13\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 4B938011-874B-5F54-8B9E-7E2A08B3AA13\\n","errorExample":""}]', + 'title' => '为一个或多个主机绑定标签', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'ListTagResources' => [ + 'summary' => '查询主机和标签的绑定关系。', + 'methods' => [ + 'get', + 'post', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '95097', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所属的地域ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ap-southeast-1', + ], + ], + [ + 'name' => 'ResourceType', + 'in' => 'query', + 'schema' => [ + 'description' => '资源类型，取值固定为DEDICATEDHOST。', + 'type' => 'string', + 'required' => true, + 'example' => 'DEDICATEDHOST', + ], + ], + [ + 'name' => 'ResourceId', + 'in' => 'query', + 'style' => 'repeatList', + 'schema' => [ + 'description' => '主机ID，可以设置多个。', + 'type' => 'array', + 'items' => [ + 'description' => '主机ID，可以设置多个。'."\n" + ."\n" + .'**N**表示窜入第几个主机ID。例如：'."\n" + ."\n" + .'- **Resourceid.1**表示传入第一个主机ID。'."\n" + ."\n" + .'- **Resourceid.2**表示传入第二个主机ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'ch-t4n4dcdvu6840****', + ], + 'required' => false, + 'maxItems' => 51, + ], + ], + [ + 'name' => 'Tag', + 'in' => 'query', + 'style' => 'repeatList', + 'schema' => [ + 'description' => '标签。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Key' => [ + 'description' => '标签的键。'."\n" + ."\n" + .'- **N**表示传入第几个标签的键。例如：'."\n" + ."\n" + .' - **Tag.1.Key**表示传入第一个标签的键。'."\n" + ."\n" + .' - **Tag.2.Key**表示传入第二个标签的键。'."\n" + ."\n" + .'- 本参数和**ResourceId.N**参数两者中必须传入一项。', + 'type' => 'string', + 'required' => false, + 'example' => 'demokey', + ], + 'Value' => [ + 'description' => '标签的值。'."\n" + ."\n" + .'- **N**表示传入第几个标签的值。例如： '."\n" + ."\n" + .' - **Tag.1.Value**表示传入第一个标签的值。'."\n" + ."\n" + .' - **Tag.2.Value**表示传入第二个标签的值。'."\n" + ."\n" + .'- 如果标签的值不存在，则自动创建。', + 'type' => 'string', + 'required' => false, + 'example' => 'demovalue', + ], + ], + 'required' => false, + ], + 'required' => false, + 'maxItems' => 21, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => '2853CAA0-D7A2-5CAB-B3A8-BDE2994F320C', + ], + 'TagResources' => [ + 'description' => '主机和标签的信息。', + 'type' => 'array', + 'items' => [ + 'description' => '主机和标签的信息。', + 'type' => 'object', + 'properties' => [ + 'TagValue' => [ + 'description' => '标签的值。'."\n" + ."\n", + 'type' => 'string', + 'example' => 'demovalue', + ], + 'ResourceType' => [ + 'description' => '资源类型。'."\n" + ."\n" + .'返回值固定为ALIYUN::CDDC::DEDICATEDHOST，即阿里云专属集群主机。', + 'type' => 'string', + 'example' => 'ALIYUN::CDDC::DEDICATEDHOST', + ], + 'ResourceId' => [ + 'description' => '主机ID。', + 'type' => 'string', + 'example' => 'ch-t4n4dcdvu6840****', + ], + 'TagKey' => [ + 'description' => '标签的键。', + 'type' => 'string', + 'example' => 'demokey', + ], + ], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'MissingResourceType', + 'errorMessage' => 'The specified parameter ResourceType is not valid.', + ], + [ + 'errorCode' => 'MissParameter.TagOrResourceId', + 'errorMessage' => 'The parameter Tag.n or ResourceId.n is needed.', + ], + [ + 'errorCode' => 'InvalidParameter.TagValue', + 'errorMessage' => 'The Tag.%s.Value parameter - %s is invalid', + ], + [ + 'errorCode' => 'InvalidParameter.TagKey', + 'errorMessage' => 'The Tag.%s.Key parameter - %s is invalid', + ], + [ + 'errorCode' => 'NumberExceed.ResourceIds', + 'errorMessage' => 'The ResourceIds parameter\'s number is exceed , Valid : 50', + ], + [ + 'errorCode' => 'InvalidTagValue.Malformed', + 'errorMessage' => 'The specified parameter "Tag.n.Value" is not valid.', + ], + [ + 'errorCode' => 'InvalidDedicatedHostId.NotFound', + 'errorMessage' => 'The parameter - ResourceIds.N is not found.', + ], + [ + 'errorCode' => 'InvalidParameter.ResourceType', + 'errorMessage' => 'The specified parameter "ResourceType" is not valid.', + ], + [ + 'errorCode' => 'NumberExceed.Tags', + 'errorMessage' => 'The Tags parameter\'s number is exceed, Valid : 20.', + ], + [ + 'errorCode' => 'MissingParameter.ResourceIds', + 'errorMessage' => 'The parameter - ResourceIds.N should not be null.', + ], + [ + 'errorCode' => 'Duplicate.TagKey', + 'errorMessage' => 'The Tag.N.Key contain duplicate key.', + ], + [ + 'errorCode' => 'InvalidTagKey.Malformed', + 'errorMessage' => 'The Tag.N.Key parameter is invalid.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2853CAA0-D7A2-5CAB-B3A8-BDE2994F320C\\",\\n \\"TagResources\\": [\\n {\\n \\"TagValue\\": \\"demovalue\\",\\n \\"ResourceType\\": \\"ALIYUN::CDDC::DEDICATEDHOST\\",\\n \\"ResourceId\\": \\"ch-t4n4dcdvu6840****\\",\\n \\"TagKey\\": \\"demokey\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 2853CAA0-D7A2-5CAB-B3A8-BDE2994F320C\\n \\n demovalue\\n ALIYUN::CDDC::DEDICATEDHOST\\n ch-t4n4dcdvu6840****\\n demokey\\n \\n","errorExample":""}]', + 'title' => '调用 ListTagResources 查询主机和标签的绑定关系', + ], + 'UntagResources' => [ + 'summary' => '将主机的标签解绑。', + 'methods' => [ + 'get', + 'post', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'delete', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '95095', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所属的地域ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ap-southeast-1', + ], + ], + [ + 'name' => 'ResourceId', + 'in' => 'query', + 'style' => 'repeatList', + 'schema' => [ + 'description' => '主机ID，可以设置多个。'."\n", + 'type' => 'array', + 'items' => [ + 'description' => '主机ID，可以设置多个。'."\n" + ."\n" + .'**N**表示窜入第几个主机ID。例如：'."\n" + ."\n" + .'- **Resourceid.1**表示传入第一个主机ID。'."\n" + ."\n" + .'- **Resourceid.2**表示传入第二个主机ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'ch-t4n4dcdvu6840****', + ], + 'required' => true, + 'maxItems' => 51, + ], + ], + [ + 'name' => 'TagKey', + 'in' => 'query', + 'style' => 'repeatList', + 'schema' => [ + 'description' => '标签的键。', + 'type' => 'array', + 'items' => [ + 'description' => '标签的键。'."\n" + ."\n" + .'- **N**表示传入第几个标签的键。例如：'."\n" + ."\n" + .' - **Tag.1.Key**表示传入第一个标签的键。'."\n" + ."\n" + .' - **Tag.2.Key**表示传入第二个标签的键。'."\n" + ."\n" + .'- 如果标签的键不存在，则自动创建。', + 'type' => 'string', + 'required' => false, + 'example' => 'demokey', + ], + 'required' => false, + 'maxItems' => 21, + ], + ], + [ + 'name' => 'All', + 'in' => 'query', + 'schema' => [ + 'description' => '是否解绑主机上的所有标签，取值：'."\n" + ."\n" + .'- **true**：解绑主机上的所有标签。'."\n" + ."\n" + .'- **false**：不解绑上主机的所有标签，默认值。'."\n" + ."\n" + .'> 如果同时设置了TagKey.N和本参数，则本参数不生效。', + 'type' => 'boolean', + 'required' => false, + 'example' => 'false', + ], + ], + [ + 'name' => 'ResourceType', + 'in' => 'query', + 'schema' => [ + 'description' => '资源类型，取值固定为DEDICATEDHOST。', + 'type' => 'string', + 'required' => true, + 'example' => 'DEDICATEDHOST', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'description' => '请求ID。', + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'B74AD197-214C-50F2-BF7D-B13632EE4D75', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'NoPermission.SystemTag', + 'errorMessage' => 'The operator is not permission for the system tag', + ], + [ + 'errorCode' => 'InvalidParameter.TagValue', + 'errorMessage' => 'The Tag.%s.Value parameter - %s is invalid', + ], + [ + 'errorCode' => 'InvalidParameter.TagKey', + 'errorMessage' => 'The Tag.%s.Key parameter - %s is invalid', + ], + [ + 'errorCode' => 'NumberExceed.ResourceIds', + 'errorMessage' => 'The ResourceIds parameter\'s number is exceed , Valid : 50', + ], + [ + 'errorCode' => 'InvalidTagValue.Malformed', + 'errorMessage' => 'The specified parameter "Tag.n.Value" is not valid.', + ], + [ + 'errorCode' => 'InvalidDedicatedHostId.NotFound', + 'errorMessage' => 'The parameter - ResourceIds.N is not found.', + ], + [ + 'errorCode' => 'InvalidParameter.ResourceType', + 'errorMessage' => 'The specified parameter "ResourceType" is not valid.', + ], + [ + 'errorCode' => 'NumberExceed.Tags', + 'errorMessage' => 'The Tags parameter\'s number is exceed, Valid : 20.', + ], + [ + 'errorCode' => 'MissingParameter.ResourceIds', + 'errorMessage' => 'The parameter - ResourceIds.N should not be null.', + ], + [ + 'errorCode' => 'Duplicate.TagKey', + 'errorMessage' => 'The Tag.N.Key contain duplicate key.', + ], + [ + 'errorCode' => 'InvalidTagKey.Malformed', + 'errorMessage' => 'The Tag.N.Key parameter is invalid.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"B74AD197-214C-50F2-BF7D-B13632EE4D75\\"\\n}","errorExample":""},{"type":"xml","example":"\\n B74AD197-214C-50F2-BF7D-B13632EE4D75\\n","errorExample":""}]', + 'title' => '将主机的标签解绑', + ], + 'CreateDedicatedHostAccount' => [ + 'summary' => '调用CreateDedicatedHostAccount接口创建主机账号。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74474', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'DedicatedHostId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机ID。可调用[DescribeDedicatedHosts](~~200944~~)获取。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ch-bp10a5id3boqi****', + ], + ], + [ + 'name' => 'AccountName', + 'in' => 'query', + 'schema' => [ + 'description' => '自定义主机账号名称。'."\n" + .'* 长度为2~16个字符。'."\n" + .'* 以字母开头，以字母或数字结尾。'."\n" + .'* 由小写字母、数字、下划线（_）组成。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'test', + ], + ], + [ + 'name' => 'AccountPassword', + 'in' => 'query', + 'schema' => [ + 'description' => '主机账号名的密码。密码要求：'."\n" + .'* 长度为6~32位。'."\n" + .'* 大写字母、小写字母、数字、特殊字符。'."\n" + .'* 特殊字符为：`!@#$%^&*()_+-=`'."\n" + ."\n" + .'> 您的引擎为SQL Server时，密码要求不能包含账户名（忽略大小写）。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'testxxxxxx', + ], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所在地域ID。可调用[DescribeDedicatedHostAttribute](~~213010~~)获取。', + 'type' => 'string', + 'required' => false, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'BastionInstanceId', + 'in' => 'query', + 'schema' => [ + 'description' => '关联的堡垒机ID，可以在云数据库专属集群控制台**堡垒机列表**查看。', + 'type' => 'string', + 'required' => false, + 'example' => 'bastionhost-cn-xxxxxxxxxxx', + ], + ], + [ + 'name' => 'AccountType', + 'in' => 'query', + 'schema' => [ + 'description' => '主机账号类型，取值：'."\n" + .'- **Normal**：普通账号。'."\n" + .'- **Admin**： 管理员账号。'."\n" + ."\n" + .'关于主机账号的权限说明，请参见[主机权限说明](~~176240~~)。', + 'type' => 'string', + 'required' => false, + 'example' => 'Admin', + ], + ], + [ + 'name' => 'ClientToken', + 'in' => 'query', + 'schema' => [ + 'description' => '由客户端生成该参数值，用于保证请求的幂等性，防止重复提交请求。字符长度不超过64个ASCII字符，且该参数值中不能包含非ASCII字符。', + 'type' => 'string', + 'required' => false, + 'docRequired' => true, + 'example' => 'ETnLKlblzczshOTUbOCz*******', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22E12AS', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'InvalidAccountPassword.Format', + 'errorMessage' => 'The account password format is invalid.', + ], + ], + 403 => [ + [ + 'errorCode' => 'InvalidAction.NotSupport', + 'errorMessage' => 'The host status does not support the operation.', + ], + ], + [ + [ + 'errorCode' => 'HostInfo.NotFound', + 'errorMessage' => 'The host is not found.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22E12AS\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\nD6E068C3-25BC-455A-85FE-45F0B22E12AS\\r\\n","errorExample":""}]', + 'title' => '创建专用主机帐户', + 'description' => '每个主机只可以拥有一个主机账号，您必须删除之前的主机账号，才可创建新的主机账号，更多信息请参见，[创建主机账号](~~211413~~)。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'DeleteDedicatedHostAccount' => [ + 'summary' => '调用DeleteDedicatedHostAccount接口删除主机账号。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'delete', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74477', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'DedicatedHostId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机ID。可调用[DescribeDedicatedHosts](~~200944~~)获取。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ch-bp10a5id3boqi****', + ], + ], + [ + 'name' => 'AccountName', + 'in' => 'query', + 'schema' => [ + 'description' => '主机账号名称。'."\n" + ."\n" + .'- 由小写字母、数字、下划线组成。'."\n" + ."\n" + .'- 以字母开头，以字母或数字结尾。'."\n" + ."\n" + .'- 包含2~16个字符。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'test', + ], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所在地域ID。可调用[DescribeDedicatedHostAttribute](~~213010~~)获取。', + 'type' => 'string', + 'required' => false, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22E12AS', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 404 => [ + [ + 'errorCode' => 'HostInfo.NotFound', + 'errorMessage' => 'Specified hostinfo is not found.', + ], + [ + 'errorCode' => 'InvalidAccountName.NotFound', + 'errorMessage' => 'Specified account name does not exist.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22E12AS\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n D6E068C3-25BC-455A-85FE-45F0B22E12AS\\r\\n ","errorExample":""}]', + 'title' => '删除专属主机账号', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'ModifyDedicatedHostPassword' => [ + 'summary' => '调用ModifyDedicatedHostPassword接口修改主机root密码。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '76558', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所在地域ID。可调用[DescribeDedicatedHostAttribute](~~213010~~)获取。', + 'type' => 'string', + 'required' => false, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'NewPassword', + 'in' => 'query', + 'schema' => [ + 'description' => '新密码。密码要求：'."\n" + ."\n" + .'- 长度为8~32位。'."\n" + ."\n" + .'- 须同时包含大写、小写、数字、特殊字符中的3种。'."\n" + ."\n" + .'- 特殊字符为：`!@#$%^&*()_+-=`'."\n" + ."\n" + .'> 当您的引擎为SQL Server时，密码要求不能包含账户名（忽略大小写）。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'test*****', + ], + ], + [ + 'name' => 'DedicatedHostId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机ID。可调用[DescribeDedicatedHosts](~~200944~~)获取。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ch-bp10a5id3boqi**** ', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'DedicatedHostName' => [ + 'description' => '主机名称。', + 'type' => 'string', + 'example' => 'test123****', + ], + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22E12AS', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 404 => [ + [ + 'errorCode' => 'InvalidDBInstance.NotFound', + 'errorMessage' => 'The specified instance does not exist or is not supported.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"DedicatedHostName\\": \\"test123****\\",\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22E12AS\\"\\n}","errorExample":""},{"type":"xml","example":"\\nD6E068C3-25BC-455A-85FE-45F0B22E12AS\\ntest123****\\n","errorExample":""}]', + 'title' => '修改专属主机密码', + 'description' => '本接口当前仅支持Tair主机。'."\n", + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'ModifyDedicatedHostAccount' => [ + 'summary' => '修改专属集群主机账号。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74525', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'DedicatedHostId', + 'in' => 'query', + 'schema' => [ + 'description' => '需要修改主机账号的主机ID。可调用[DescribeDedicatedHosts](~~200944~~)获取目标主机ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ch-bp10a5id3boqi****', + ], + ], + [ + 'name' => 'AccountName', + 'in' => 'query', + 'schema' => [ + 'description' => '主机账号名称。'."\n", + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'test', + ], + ], + [ + 'name' => 'AccountPassword', + 'in' => 'query', + 'schema' => [ + 'description' => '主机账号密码。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'test*****', + ], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '需要修改主机账号的主机所在地域ID。可调用[DescribeDedicatedHostAttribute](~~213010~~)获取。', + 'type' => 'string', + 'required' => false, + 'docRequired' => true, + 'example' => 'cn-hangzhou', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22ECB1F', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + [ + 'errorCode' => 'InvalidUserId.NotSupport', + 'errorMessage' => 'The userid have no permission.', + ], + ], + 404 => [ + [ + 'errorCode' => 'HostInfo.NotFound', + 'errorMessage' => 'Specified hostinfo is not found.', + ], + [ + 'errorCode' => 'InvalidAccountName.NotFound', + 'errorMessage' => 'Specified account name does not exist.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22ECB1F\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\nD6E068C3-25BC-455A-85FE-45F0B22ECB1F\\r\\n","errorExample":""}]', + 'title' => '修改专属集群主机账号', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'QueryHostInstanceConsoleInfo' => [ + 'summary' => '调用QueryHostInstanceConsoleInfo接口查询主机实例节点列表。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74534', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机所在地域ID。您可以登录云数据库专属集群控制台，查看[地域信息](~~198326~~)。', + 'type' => 'string', + 'required' => false, + 'docRequired' => true, + 'example' => 'cn-qingdao', + ], + ], + [ + 'name' => 'DedicatedHostId', + 'in' => 'query', + 'schema' => [ + 'description' => '主机ID。您可以登录云数据库专属集群控制台，在**主机列表**查看并获取主机ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'ch-bp1fgj3kt7fsb****', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22ECB1F', + ], + 'HostInstanceConsoleInfos' => [ + 'description' => '实例信息列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Status' => [ + 'description' => '实例状态描述。', + 'type' => 'string', + 'example' => 'RUNNING', + ], + 'MaxConnIncreaseRatioValue' => [ + 'description' => '上弹连接数。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '1300', + ], + 'MemSize' => [ + 'description' => '实例规格内存，单位为GB。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '16', + ], + 'DiskSize' => [ + 'description' => '实例存储空间，单位为GB。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '500', + ], + 'Ip' => [ + 'description' => '实例所在主机IP。', + 'type' => 'string', + 'example' => '172.22.XX.XX', + ], + 'Port' => [ + 'description' => '主机端口。', + 'type' => 'string', + 'example' => '3443', + ], + 'EngineVersion' => [ + 'description' => '数据库版本。', + 'type' => 'string', + 'example' => '5.8', + ], + 'MemoryIncreaseRatioValue' => [ + 'description' => '上弹内存配置。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '64', + ], + 'CpuIncreaseRatioValue' => [ + 'description' => '上弹CPU配置。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '16', + ], + 'DBInstanceId' => [ + 'description' => '实例ID。', + 'type' => 'string', + 'example' => 'rm-bp1m5z8002gyj****', + ], + 'Engine' => [ + 'description' => '数据库类型。', + 'type' => 'string', + 'example' => 'mysql', + ], + 'LevelName' => [ + 'description' => '实例规格描述。', + 'type' => 'string', + 'example' => 'mysql.z2.medium.2', + ], + 'Role' => [ + 'description' => '实例角色。', + 'type' => 'string', + 'example' => 'master', + ], + 'DBInstanceDescription' => [ + 'description' => '实例描述。', + 'type' => 'string', + 'example' => 'rm-bp1m5z8002gyj****', + ], + 'CpuCores' => [ + 'description' => '实例规格CPU，单位为核。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '8', + ], + 'PerfInfo' => [ + 'description' => '实例所在主机性能信息。', + 'type' => 'object', + 'properties' => [ + 'PerfIdbPio' => [ + 'description' => '实例所在主机物理IO。', + 'type' => 'number', + 'format' => 'float', + 'example' => '30', + ], + 'DiskCurr' => [ + 'description' => '实例所在主机磁盘空间，单位为GB。', + 'type' => 'number', + 'format' => 'float', + 'example' => '1000', + ], + 'MemRatio' => [ + 'description' => '实例所在主机内存大小，单位为GB。', + 'type' => 'number', + 'format' => 'float', + 'example' => '64', + ], + 'CpuRatio' => [ + 'description' => '实例所在主机CPU大小，单位为核。', + 'type' => 'number', + 'format' => 'float', + 'example' => '16', + ], + ], + ], + ], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + [ + 'errorCode' => 'Permission.NotSupport', + 'errorMessage' => 'You are not authorized to perform this action.', + ], + [ + 'errorCode' => 'Forbidden.RAM', + 'errorMessage' => 'User not authorized to operate on the specified resource, or this API does not support RAM.', + ], + ], + [ + [ + 'errorCode' => 'HostInfo.NotFound', + 'errorMessage' => 'The host is not found.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22ECB1F\\",\\n \\"HostInstanceConsoleInfos\\": [\\n {\\n \\"Status\\": \\"RUNNING\\",\\n \\"MaxConnIncreaseRatioValue\\": 1300,\\n \\"MemSize\\": 16,\\n \\"DiskSize\\": 500,\\n \\"Ip\\": \\"172.22.XX.XX\\",\\n \\"Port\\": \\"3443\\",\\n \\"EngineVersion\\": \\"5.8\\",\\n \\"MemoryIncreaseRatioValue\\": 64,\\n \\"CpuIncreaseRatioValue\\": 16,\\n \\"DBInstanceId\\": \\"rm-bp1m5z8002gyj****\\",\\n \\"Engine\\": \\"mysql\\",\\n \\"LevelName\\": \\"mysql.z2.medium.2\\",\\n \\"Role\\": \\"master\\",\\n \\"DBInstanceDescription\\": \\"rm-bp1m5z8002gyj****\\",\\n \\"CpuCores\\": 8,\\n \\"PerfInfo\\": {\\n \\"PerfIdbPio\\": 30,\\n \\"DiskCurr\\": 1000,\\n \\"MemRatio\\": 64,\\n \\"CpuRatio\\": 16\\n }\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n D6E068C3-25BC-455A-85FE-45F0B22ECB1F\\n \\n RUNNING\\n 1300\\n 16\\n 500\\n 172.22.XX.XX\\n 3443\\n 5.8\\n 64\\n 16\\n rm-bp1m5z8002gyj****\\n mysql\\n mysql.z2.medium.2\\n master\\n rm-bp1m5z8002gyj****\\n 8\\n \\n 30\\n 1000\\n 64\\n 16\\n \\n \\n","errorExample":""}]', + 'title' => '查询主机实例节点列表', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'QueryHostBaseInfoByInstance' => [ + 'summary' => '调用QueryHostBaseInfoByInstance接口查询实例所在主机基本信息。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'http', + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '74533', + 'abilityTreeNodes' => [ + 'FEATUREcddcZHIXH7', + ], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '实例所在地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'required' => false, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => [ + 'description' => '实例ID。', + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'rm-bp15rszyxs4t3****', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'description' => '请求ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22E12CV', + ], + 'HostInstanceConsoleInfos' => [ + 'description' => '主机上实例信息概览。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'VpcId' => [ + 'description' => '实例所在主机专有网络ID 。', + 'type' => 'string', + 'example' => 'vpc-bp1ov7as4yvz4kxei****', + ], + 'Status' => [ + 'description' => '实例状态描述。', + 'type' => 'string', + 'example' => 'RUNNING', + ], + 'ExpiredTime' => [ + 'description' => '实例到期时间。', + 'type' => 'string', + 'example' => '2021.07.20', + ], + 'ClusterName' => [ + 'description' => '实例规格描述。', + 'type' => 'string', + 'example' => 'rds.ebmr6.26xlarge', + ], + 'Ip' => [ + 'description' => '实例所在主机IP地址。', + 'type' => 'string', + 'example' => ' 172.22.0.***', + ], + 'HostName' => [ + 'description' => '实例所在主机名称。', + 'type' => 'string', + 'example' => 'ch-bp1fgj3kt7fsb****', + ], + 'Engine' => [ + 'description' => '数据库类型。', + 'type' => 'string', + 'example' => 'mysql', + ], + 'Role' => [ + 'description' => '实例角色。', + 'type' => 'string', + 'example' => 'master', + ], + 'Port' => [ + 'description' => '实例所在主机端口。', + 'type' => 'string', + 'example' => '3443', + ], + 'EngineVersion' => [ + 'description' => '数据库版本。', + 'type' => 'string', + 'example' => '5.7', + ], + ], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + [ + 'errorCode' => 'Permission.NotSupport', + 'errorMessage' => 'You are not authorized to perform this action.', + ], + ], + [ + [ + 'errorCode' => 'InvalidDBInstance.NotFound', + 'errorMessage' => 'The specified instance does not exist or is not supported.', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22E12CV\\",\\n \\"HostInstanceConsoleInfos\\": [\\n {\\n \\"VpcId\\": \\"vpc-bp1ov7as4yvz4kxei****\\",\\n \\"Status\\": \\"RUNNING\\",\\n \\"ExpiredTime\\": \\"2021.07.20\\",\\n \\"ClusterName\\": \\"rds.ebmr6.26xlarge\\",\\n \\"Ip\\": \\" 172.22.0.***\\",\\n \\"HostName\\": \\"ch-bp1fgj3kt7fsb****\\",\\n \\"Engine\\": \\"mysql\\",\\n \\"Role\\": \\"master\\",\\n \\"Port\\": \\"3443\\",\\n \\"EngineVersion\\": \\"5.7\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\nD6E068C3-25BC-455A-85FE-45F0B22E12CV\\n\\n RUNNING\\n master\\n 5.7\\n vpc-bp1ov7as4yvz4kxei****\\n 2021.07.20\\n 3443\\n 172.22.0.***\\n rds.ebmr6.26xlarge\\n ch-bp1fgj3kt7fsb****\\n mysql\\n\\n","errorExample":""}]', + 'title' => '查看实例所在主机基本信息', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + ], + 'AddPrinsInstance' => [ + 'summary' => '添加 MyBase 自建纳管实例。', + 'methods' => [ + 'get', + 'post', + ], + 'schemes' => [ + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '226388', + 'abilityTreeNodes' => [ + 'FEATUREcddcSRVFXT', + ], + 'tenantRelevance' => 'publicInformation', + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'required' => false, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'EcsInstanceId', + 'in' => 'query', + 'schema' => [ + 'description' => '指定纳管的 ECS 实例 ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'i-bp1726beecvi8kak****', + ], + ], + [ + 'name' => 'Engine', + 'in' => 'query', + 'schema' => [ + 'description' => '根据数据库引擎类型过滤主机列表。取值：'."\n" + ."\n" + .'- MySQL', + 'type' => 'string', + 'required' => false, + 'example' => 'MySQL', + ], + ], + [ + 'name' => 'Ip', + 'in' => 'query', + 'schema' => [ + 'description' => 'IP 信息。', + 'type' => 'string', + 'required' => false, + 'example' => '127.0.0.1', + ], + ], + [ + 'name' => 'Port', + 'in' => 'query', + 'schema' => [ + 'description' => '实例端口号。', + 'type' => 'string', + 'required' => false, + 'example' => '3306', + ], + ], + [ + 'name' => 'Disk', + 'in' => 'query', + 'style' => 'json', + 'schema' => [ + 'description' => '磁盘列表。', + 'type' => 'array', + 'items' => [ + 'description' => '磁盘信息。', + 'type' => 'object', + 'properties' => [ + 'Type' => [ + 'description' => '云盘或本地盘的类型 ，取值：'."\n" + ."\n" + .'- **system**：系统盘'."\n" + ."\n" + .'- **data**： 数据盘', + 'type' => 'string', + 'required' => false, + 'example' => 'system', + ], + 'DiskId' => [ + 'description' => '云盘或本地盘ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'd-2vc9qpza81r6t2nx****', + ], + 'Category' => [ + 'description' => '磁盘类型。取值范围：'."\n" + .' - **cloud_efficiency**：高效云盘。'."\n" + .' - **cloud_ssd**：SSD云盘。'."\n" + .' - **cloud_essd**：ESSD云盘。'."\n" + .' - **cloud**：普通云盘。', + 'type' => 'string', + 'required' => false, + 'example' => 'cloud_essd', + ], + 'Device' => [ + 'description' => '云盘或本地盘挂载实例的设备名。', + 'type' => 'string', + 'required' => false, + 'example' => '/dev/xvda', + ], + 'Mount' => [ + 'description' => '挂载目录。', + 'type' => 'string', + 'required' => false, + 'example' => '/data', + ], + ], + 'required' => false, + ], + 'required' => false, + ], + ], + [ + 'name' => 'Username', + 'in' => 'query', + 'schema' => [ + 'description' => '数据库用户名', + 'type' => 'string', + 'required' => false, + 'example' => 'username', + ], + ], + [ + 'name' => 'Password', + 'in' => 'query', + 'schema' => [ + 'description' => '数据库连接密码。', + 'type' => 'string', + 'required' => false, + 'example' => 'password', + ], + ], + [ + 'name' => 'SecurityGroupId', + 'in' => 'query', + 'schema' => [ + 'description' => '纳管实例时指定的安全组 ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'sg-t4neld965n89ocvt****', + ], + ], + [ + 'name' => 'Alias', + 'in' => 'query', + 'schema' => [ + 'description' => '实例别名。', + 'type' => 'string', + 'required' => false, + 'example' => 'alias', + ], + ], + [ + 'name' => 'Description', + 'in' => 'query', + 'schema' => [ + 'description' => '实例描述。', + '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。', + 'type' => 'string', + 'example' => 'D5C887C7-EAF1-40B7-88FE-2C45D4DB****', + ], + 'CustInstanceId' => [ + 'description' => '实例 ID。', + 'type' => 'string', + 'example' => '1', + ], + 'CustInstanceName' => [ + 'description' => '实例全局唯一的名称。', + 'type' => 'string', + 'example' => 'pr-22a21ac289e0****', + ], + ], + ], + ], + ], + 'staticInfo' => [ + 'returnType' => 'synchronous', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D5C887C7-EAF1-40B7-88FE-2C45D4DB****\\",\\n \\"CustInstanceId\\": \\"1\\",\\n \\"CustInstanceName\\": \\"pr-22a21ac289e0****\\"\\n}","type":"json"}]', + 'title' => '添加纳管实例', + ], + 'CreatePrinsBackupPlan' => [ + 'summary' => '为纳管实例创建备份计划。', + 'methods' => [ + 'get', + 'post', + ], + 'schemes' => [ + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'paid', + 'abilityTreeCode' => '212746', + 'abilityTreeNodes' => [ + 'FEATUREcddcGJUHY1', + ], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'required' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'InstanceName', + 'in' => 'query', + 'schema' => [ + 'description' => '自建纳管实例的名称', + 'type' => 'string', + 'required' => true, + 'example' => 'pr-22a21ac289e0****', + ], + ], + [ + 'name' => 'InstanceClass', + 'in' => 'query', + 'schema' => [ + 'description' => '备份计划的规格，取值：'."\n" + .'- **micro**'."\n" + .'- **small**'."\n" + .'- **medium**'."\n" + .'- **large**'."\n" + .'- **xlarge**', + 'type' => 'string', + 'required' => true, + 'example' => 'micro', + 'enum' => [ + 'micro', + 'small', + 'medium', + 'large', + 'xlarge', + ], + ], + ], + [ + 'name' => 'Period', + 'in' => 'query', + 'schema' => [ + 'description' => '购买时长。', + 'type' => 'string', + 'required' => true, + 'example' => 'Month', + 'enum' => [ + 'Month', + 'Year', + ], + ], + ], + [ + 'name' => 'UsedTime', + 'in' => 'query', + 'schema' => [ + 'description' => '指定购买时长，取值如下：'."\n" + .'- 当参数**Period**为**Year**时，**UsedTime**取值为1~5。'."\n" + .'- 当参数**Period**为**Month**时，**UsedTime**取值为1~11。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => true, + 'maximum' => '11', + 'minimum' => '1', + 'example' => '1', + ], + ], + [ + 'name' => 'EcsInstanceId', + 'in' => 'query', + 'schema' => [ + 'description' => '指定备份的 ECS 实例 ID。', + 'type' => 'string', + 'required' => true, + 'example' => 'i-bp1726beecvi8kak****', + ], + ], + [ + 'name' => 'BackupPeriod', + 'in' => 'query', + 'schema' => [ + 'description' => '全量备份周期，取值：'."\n" + ."\n" + .'- Monday：周一'."\n" + .'- Tuesday：周二'."\n" + .'- Wednesday：周三'."\n" + .'- Thursday：周四'."\n" + .'- Friday：周五'."\n" + .'- Saturday：周六'."\n" + .'- Sunday：周日'."\n" + ."\n" + .'> '."\n" + .'> - 支持选择多个取值，用英文逗号（,）分开。', + 'type' => 'string', + 'required' => true, + 'example' => 'Monday', + ], + ], + [ + 'name' => 'BackupStartTime', + 'in' => 'query', + 'schema' => [ + 'description' => '备份开始时间，格式为HH:mm。', + 'type' => 'string', + 'required' => true, + 'example' => '14:22', + ], + ], + [ + 'name' => 'BackupPlanName', + 'in' => 'query', + 'schema' => [ + 'description' => '自定义备份计划名称。', + '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' => '22A601D7-3E6E-559D-B845-F643142C611E', + ], + 'BackupPlanId' => [ + 'description' => ' '."\n" + .'备份计划ID。', + 'type' => 'string', + 'example' => 'dbsrhm5j8rm****', + ], + ], + ], + ], + ], + 'staticInfo' => [ + 'returnType' => 'synchronous', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"22A601D7-3E6E-559D-B845-F643142C611E\\",\\n \\"BackupPlanId\\": \\"dbsrhm5j8rm****\\"\\n}","type":"json"}]', + 'title' => '创建备份计划', + 'description' => '请确保在使用该接口前，已充分了解 DBS 产品备份计划的收费方式和[价格](~~2858407~~)。', + ], + 'DescribePrinsInstance' => [ + 'summary' => '获取纳管实例详情。', + 'methods' => [ + 'get', + 'post', + ], + 'schemes' => [ + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '212752', + 'abilityTreeNodes' => [ + 'FEATUREcddcGJUHY1', + ], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'InstanceName', + 'in' => 'query', + 'schema' => [ + 'description' => '自建纳管实例名称。', + 'type' => 'string', + 'required' => false, + 'example' => 'pr-22a21ac289e0****', + ], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '[地域ID](~~198326~~)。', + 'type' => 'string', + 'required' => false, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'Discover', + 'in' => 'query', + 'schema' => [ + 'description' => '是否查询关联的主从实例。', + 'type' => 'boolean', + 'required' => false, + 'example' => 'false', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'title' => 'Id of the request', + 'description' => '请求 ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22E****', + ], + 'DbInstance' => [ + 'description' => '纳管实例详情。', + 'type' => 'object', + 'properties' => [ + 'RegionId' => [ + 'description' => '地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'example' => 'cn-hangzhou', + ], + 'InstanceName' => [ + 'description' => '自建纳管实例的名称。', + 'type' => 'string', + 'example' => 'pr-22a21ac289e0****', + ], + 'EngineType' => [ + 'description' => '引擎类型，取值：'."\n" + .'- **MySQL** 。', + 'type' => 'string', + 'example' => 'MySQL', + ], + 'EngineVersion' => [ + 'description' => '数据库版本。', + 'type' => 'string', + 'example' => '8.0.36', + ], + 'Status' => [ + 'description' => '实例状态。', + 'type' => 'string', + 'enumValueTitles' => [ + 'inacitve' => '异常', + 'deleted' => '已删除', + 'creating' => '创建中', + 'active' => '运行中', + ], + 'example' => 'active', + ], + 'InstanceClass' => [ + 'description' => '实例规格。', + 'type' => 'string', + 'example' => '2C4G', + ], + 'InstanceStorageType' => [ + 'description' => '实例存储类型。', + 'type' => 'string', + 'example' => 'cloud_essd', + ], + 'InstanceStorageCapacity' => [ + 'description' => '存储容量。', + 'type' => 'string', + 'example' => '40', + ], + 'GmtCreated' => [ + 'description' => '实例创建时间的时间戳。', + 'type' => 'string', + 'example' => '1729758903000', + ], + 'NetworkType' => [ + 'description' => '实例网络类型。', + 'type' => 'string', + 'example' => 'vpc', + ], + 'VpcId' => [ + 'description' => '实例所在的专有网络ID 。', + 'type' => 'string', + 'example' => 'vpc-uf6idhbqkbuw11kw3****', + ], + 'Description' => [ + 'description' => '实例描述。', + 'type' => 'string', + 'example' => 'test', + ], + 'HostInstances' => [ + 'description' => '实例包含的主机列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'GmtCreated' => [ + 'description' => '主机创建时间的时间戳。', + 'type' => 'string', + 'example' => '1729758903000', + ], + 'InstanceId' => [ + 'description' => 'ECS 实例 ID。', + 'type' => 'string', + 'example' => 'i-bp1gmm4pnacse343****', + ], + 'InstanceClass' => [ + 'description' => 'ECS 规格信息。', + 'type' => 'string', + 'example' => 'ecs.c7.large', + ], + 'IpAddress' => [ + 'description' => 'ECS 的 IP地址。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Ip' => [ + 'description' => 'IP 信息。', + 'type' => 'string', + 'example' => '127.0.0.1', + ], + 'Port' => [ + 'description' => '实例端口号。', + 'type' => 'string', + 'example' => '3306', + ], + 'Type' => [ + 'description' => 'IP 地址类型，取值：'."\n" + ."\n" + .'- **Private**：内网 IP'."\n" + ."\n" + .'- **Public**： 外网 IP', + 'type' => 'string', + 'example' => 'Private', + ], + ], + ], + ], + 'InstanceName' => [ + 'description' => 'ECS 实例名称。', + 'type' => 'string', + 'example' => 'launch-advisor-20250603', + ], + 'Status' => [ + 'description' => 'ECS 主机状态。', + 'type' => 'string', + 'enumValueTitles' => [ + 'deleted' => '已删除', + 'inactive' => '异常', + 'active' => '运行中', + ], + 'example' => 'active', + ], + 'ZoneId' => [ + 'description' => '可用区ID。', + 'type' => 'string', + 'example' => 'cn-hangzhou-j', + ], + 'InstanceRole' => [ + 'description' => '主机角色。'."\n" + ."\n" + .'- master'."\n" + ."\n" + .'- slave', + 'type' => 'string', + 'example' => 'master', + ], + 'DiskInfo' => [ + 'description' => 'ECS磁盘信息。', + 'type' => 'array', + 'items' => [ + 'description' => 'ECS磁盘信息。', + 'type' => 'object', + 'properties' => [ + 'Id' => [ + 'description' => '磁盘 ID。', + 'type' => 'string', + 'example' => 'd-bp1ddpo8lqswottd****', + ], + 'Size' => [ + 'description' => '磁盘大小，单位为GB。', + 'type' => 'integer', + 'format' => 'int64', + 'example' => '50', + ], + 'Category' => [ + 'description' => '磁盘类型。取值范围：'."\n" + .' - **cloud_efficiency**：高效云盘。'."\n" + .' - **cloud_ssd**：SSD云盘。'."\n" + .' - **cloud_essd**：ESSD云盘。'."\n" + .' - **cloud**：普通云盘。', + 'type' => 'string', + 'example' => 'cloud_essd', + ], + 'Type' => [ + 'description' => '云盘或本地盘磁盘类型 ，取值：'."\n" + ."\n" + .'- **system**：系统盘'."\n" + ."\n" + .'- **data**： 数据盘'."\n", + 'type' => 'string', + 'example' => 'system', + ], + 'Usage' => [ + 'description' => '磁盘使用率。', + 'type' => 'string', + 'example' => '40', + ], + 'Device' => [ + 'description' => '云盘或本地盘挂载实例的设备名。', + 'type' => 'string', + 'example' => '/dev/xvda', + ], + ], + ], + ], + 'Cpu' => [ + 'description' => '主机 CPU 核数。', + 'type' => 'string', + 'example' => '2', + ], + 'Mem' => [ + 'description' => '内存大小，单位GB。', + 'type' => 'string', + 'example' => '4', + ], + 'VpcId' => [ + 'description' => '主机所在专有网络ID 。', + 'type' => 'string', + 'example' => ' vpc-bp1d5gyhoue53eu6h****', + ], + 'Port' => [ + 'description' => '主机端口。', + 'type' => 'string', + 'example' => '3306', + ], + 'Description' => [ + 'description' => '主机描述。', + 'type' => 'string', + 'example' => 'test', + ], + 'Ip' => [ + 'description' => '纳管实例时选择的主机 IP。', + 'type' => 'string', + 'example' => '127.0.0.1', + ], + 'SecurityGroupId' => [ + 'description' => '纳管实例时指定的安全组 ID。', + 'type' => 'string', + 'example' => 'sg-uf6bo3fxuuen4uxndp9j', + ], + ], + ], + ], + 'Tag' => [ + 'description' => '标签列表。', + 'type' => 'array', + 'items' => [ + 'description' => '标签信息。', + 'type' => 'object', + 'properties' => [ + 'Key' => [ + 'description' => '标签键。', + 'type' => 'string', + 'example' => 'key', + ], + 'Value' => [ + 'description' => '标签值。', + 'type' => 'string', + 'example' => 'value', + ], + ], + ], + ], + 'DmsId' => [ + 'description' => '实例关联的 dms 实例 id', + 'type' => 'string', + 'example' => '2717906', + ], + 'DasId' => [ + 'description' => '实例关联的 das 实例 id。', + 'type' => 'string', + 'example' => 'hdm_ef2263e117f23c4f3114417742b4****', + ], + 'Alias' => [ + 'description' => '实例别名。', + 'type' => 'string', + 'example' => 'alias', + ], + ], + ], + ], + ], + ], + ], + 'staticInfo' => [ + 'returnType' => 'synchronous', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22E****\\",\\n \\"DbInstance\\": {\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"InstanceName\\": \\"pr-22a21ac289e0****\\",\\n \\"EngineType\\": \\"MySQL\\",\\n \\"EngineVersion\\": \\"8.0.36\\",\\n \\"Status\\": \\"active\\",\\n \\"InstanceClass\\": \\"2C4G\\",\\n \\"InstanceStorageType\\": \\"cloud_essd\\",\\n \\"InstanceStorageCapacity\\": \\"40\\",\\n \\"GmtCreated\\": \\"1729758903000\\",\\n \\"NetworkType\\": \\"vpc\\",\\n \\"VpcId\\": \\"vpc-uf6idhbqkbuw11kw3****\\",\\n \\"Description\\": \\"test\\",\\n \\"HostInstances\\": [\\n {\\n \\"GmtCreated\\": \\"1729758903000\\",\\n \\"InstanceId\\": \\"i-bp1gmm4pnacse343****\\",\\n \\"InstanceClass\\": \\"ecs.c7.large\\",\\n \\"IpAddress\\": [\\n {\\n \\"Ip\\": \\"127.0.0.1\\",\\n \\"Port\\": \\"3306\\",\\n \\"Type\\": \\"Private\\"\\n }\\n ],\\n \\"InstanceName\\": \\"launch-advisor-20250603\\",\\n \\"Status\\": \\"active\\",\\n \\"ZoneId\\": \\"cn-hangzhou-j\\",\\n \\"InstanceRole\\": \\"master\\",\\n \\"DiskInfo\\": [\\n {\\n \\"Id\\": \\"d-bp1ddpo8lqswottd****\\",\\n \\"Size\\": 50,\\n \\"Category\\": \\"cloud_essd\\",\\n \\"Type\\": \\"system\\",\\n \\"Usage\\": \\"40\\",\\n \\"Device\\": \\"/dev/xvda\\"\\n }\\n ],\\n \\"Cpu\\": \\"2\\",\\n \\"Mem\\": \\"4\\",\\n \\"VpcId\\": \\" vpc-bp1d5gyhoue53eu6h****\\",\\n \\"Port\\": \\"3306\\",\\n \\"Description\\": \\"test\\",\\n \\"Ip\\": \\"127.0.0.1\\",\\n \\"SecurityGroupId\\": \\"sg-uf6bo3fxuuen4uxndp9j\\"\\n }\\n ],\\n \\"Tag\\": [\\n {\\n \\"Key\\": \\"key\\",\\n \\"Value\\": \\"value\\"\\n }\\n ],\\n \\"DmsId\\": \\"2717906\\",\\n \\"DasId\\": \\"hdm_ef2263e117f23c4f3114417742b4****\\",\\n \\"Alias\\": \\"alias\\"\\n }\\n}","type":"json"}]', + 'title' => '获取纳管实例详情', + ], + 'DescribePrinsBackupPlan' => [ + 'summary' => '查询在 MyBase 实例纳管页创建的 DBS 备份计划详情，返回为空时说明纳管实例未创建备份计划。', + 'methods' => [ + 'get', + 'post', + ], + 'schemes' => [ + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '212746', + 'abilityTreeNodes' => [ + 'FEATUREcddcGJUHY1', + ], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'required' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'InstanceName', + 'in' => 'query', + 'schema' => [ + 'description' => '自建纳管实例的名称。', + 'type' => 'string', + 'required' => true, + 'example' => 'pr-22a21ac289e****', + ], + ], + ], + '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' => 'D6E068C3-25BC-455A-85FE-45F0B22****', + ], + 'BackupPlan' => [ + 'description' => '备份计划详情列表。', + 'type' => 'object', + 'properties' => [ + 'BackupPlanId' => [ + 'description' => '备份计划ID。', + 'type' => 'string', + 'example' => 'dbsrhm5j8rm****', + ], + 'BackupPlanName' => [ + 'description' => '备份计划名称。', + 'type' => 'string', + 'example' => 'test****', + ], + 'UserName' => [ + 'description' => '备份使用的数据库账号名。', + 'type' => 'string', + 'example' => 'test_user', + ], + 'EcsInstanceId' => [ + 'description' => 'ECS实例ID。', + 'type' => 'string', + 'example' => 'i-bp1726beecvi8kak****', + ], + 'BackupStartTime' => [ + 'description' => '备份开始时间，格式为HH:mm。', + 'type' => 'string', + 'example' => '14:22', + ], + 'InstanceClass' => [ + 'description' => '规格，返回值如下：'."\n" + ."\n" + .'- **micro**：入门型'."\n" + .'- **small**：低配型'."\n" + .'- **medium**：中配型'."\n" + .'- **large**：高配型'."\n" + .'- **xlarge**：高配型（无流量上限）', + 'type' => 'string', + 'example' => 'micro', + ], + 'BackupPeriod' => [ + 'description' => '全量备份周期，取值：'."\n" + .'- Monday：周一'."\n" + .'- Tuesday：周二'."\n" + .'- Wednesday：周三'."\n" + .'- Thursday：周四'."\n" + .'- Friday：周五'."\n" + .'- Saturday：周六'."\n" + .'- Sunday：周日'."\n" + .'> '."\n" + .'> - 支持选择多个取值，用英文逗号（,）分开。', + 'type' => 'string', + 'example' => 'Monday', + ], + 'BackupPlanStatus' => [ + 'description' => '备份计划状态，返回值如下：'."\n" + .'- **wait**：未配置'."\n" + .'- **init**：未启动（预检查失败）'."\n" + .'- **running**：运行中'."\n" + .'- **stop**：失败'."\n" + .'- **pause**：暂停'."\n" + .'- **locked**：锁定中'."\n" + .'- **check_pass**：预检查通过', + 'type' => 'string', + 'example' => 'running', + ], + 'DatabaseType' => [ + 'description' => '数据库类型，取值如下：'."\n" + ."\n" + .'- **MYSQL**', + 'type' => 'string', + 'example' => 'MySQL', + ], + 'BackupPlanCreateTime' => [ + 'description' => '备份计划创建时间戳。', + 'type' => 'string', + 'example' => '1582527713000', + ], + 'ResourceGroupId' => [ + 'description' => '资源组ID。', + 'type' => 'string', + 'example' => 'rg-aek3ckqdbgg****', + ], + ], + ], + 'OssHint' => [ + 'description' => '用户是否已开通 OSS 服务。'."\n" + .'>若返回为 false 则无法正常创建备份计划，需要先开通 OSS 服务。>', + 'type' => 'boolean', + 'example' => 'true', + ], + ], + ], + ], + ], + 'staticInfo' => [ + 'returnType' => 'synchronous', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22****\\",\\n \\"BackupPlan\\": {\\n \\"BackupPlanId\\": \\"dbsrhm5j8rm****\\",\\n \\"BackupPlanName\\": \\"test****\\",\\n \\"UserName\\": \\"test_user\\",\\n \\"EcsInstanceId\\": \\"i-bp1726beecvi8kak****\\",\\n \\"BackupStartTime\\": \\"14:22\\",\\n \\"InstanceClass\\": \\"micro\\",\\n \\"BackupPeriod\\": \\"Monday\\",\\n \\"BackupPlanStatus\\": \\"running\\",\\n \\"DatabaseType\\": \\"MySQL\\",\\n \\"BackupPlanCreateTime\\": \\"1582527713000\\",\\n \\"ResourceGroupId\\": \\"rg-aek3ckqdbgg****\\"\\n },\\n \\"OssHint\\": true\\n}","type":"json"}]', + 'title' => '查询备份计划详情', + ], + 'DescribePrinsEcsInstances' => [ + 'summary' => '查询ECS实例信息列表。', + 'methods' => [ + 'get', + 'post', + ], + 'schemes' => [ + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '212746', + 'abilityTreeNodes' => [ + 'FEATUREcddcGJUHY1', + ], + 'tenantRelevance' => 'publicInformation', + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'required' => false, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'EcsInstanceId', + 'in' => 'query', + 'schema' => [ + 'description' => 'ECS实例ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'i-bp1726beecvi8kak****', + ], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => [ + 'description' => '每页展示数目。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '20', + ], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => [ + 'description' => '实例列表的页码，起始值为1，默认值为1。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '1', + ], + ], + [ + 'name' => 'VpcId', + 'in' => 'query', + 'schema' => [ + 'description' => '实例所在的专有网络ID 。', + 'type' => 'string', + 'required' => false, + 'example' => 'vpc-t4nbtmekgxotv0d3y****', + ], + ], + [ + 'name' => 'ZoneId', + 'in' => 'query', + 'schema' => [ + 'description' => '可用区ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'cn-hangzhou-j', + ], + ], + [ + 'name' => 'MaxResults', + 'in' => 'query', + 'schema' => [ + 'description' => '> 该参数暂未上线，当前使用 PageNumber 与 PageSize 完成分页查询操作。'."\n" + ."\n" + .'使用NextToken方式查询时，每次最多返回的结果数。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'maximum' => '100', + 'minimum' => '0', + 'example' => '20', + ], + ], + [ + 'name' => 'NextToken', + 'in' => 'query', + 'schema' => [ + 'description' => '> 该参数暂未上线，当前使用 PageNumber 与 PageSize 完成分页查询操作。'."\n" + ."\n" + .'本次调用返回的查询凭证值。', + 'type' => 'string', + 'required' => false, + 'example' => 'caeba0bbb2be03f84eb48b699f0a4883', + ], + ], + [ + 'name' => 'Keyword', + 'in' => 'query', + 'schema' => [ + 'description' => '查询关键字，模糊匹配，支持主机 ID、主机名称、主机 IP。', + 'type' => 'string', + 'required' => false, + 'example' => 'keyword', + ], + ], + ], + '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' => 'D6E068C3-25BC-455A-85FE-45F0B22E****', + ], + 'PageSize' => [ + 'description' => '每页展示数目。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '20', + ], + 'PageNumber' => [ + 'description' => '实例列表的页码，起始值为1，默认值为1。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '1', + ], + 'TotalCount' => [ + 'description' => '总记录条数', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '100', + ], + 'InstanceList' => [ + 'description' => 'ECS 实例列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'InstanceId' => [ + 'description' => 'ECS 实例 ID。', + 'type' => 'string', + 'example' => 'i-2zeaquy5es02nksh****', + ], + 'VpcId' => [ + 'description' => '主机所在专有网络ID 。', + 'type' => 'string', + 'example' => 'vpc-uf6idhbqkbuw11kw3****', + ], + 'ZoneId' => [ + 'description' => '地域下的可用区ID。', + 'type' => 'string', + 'example' => 'cn-hangzhou-j', + ], + 'InstanceName' => [ + 'description' => 'ECS 实例名称。', + 'type' => 'string', + 'example' => 'launch-advisor-20250530', + ], + 'Stauts' => [ + 'description' => '实例状态', + 'type' => 'string', + 'example' => 'Running', + ], + 'IpList' => [ + 'description' => 'IP 信息列表。', + 'type' => 'array', + 'items' => [ + 'description' => 'IP 信息。', + 'type' => 'object', + 'properties' => [ + 'Ip' => [ + 'description' => '主机 IP。', + 'type' => 'string', + 'example' => '127.0.0.1', + ], + 'Type' => [ + 'description' => 'IP 地址类型，取值：'."\n" + ."\n" + .'- **Private**：内网 IP'."\n" + ."\n" + .'- **Public**： 外网 IP', + 'type' => 'string', + 'example' => 'Private', + ], + ], + ], + ], + 'SecurityGroups' => [ + 'description' => '安全组列表信息。', + 'type' => 'array', + 'items' => [ + 'description' => '安全组 ID', + 'type' => 'string', + 'example' => 'sg-uf66unlpw292cgh6****', + ], + ], + 'Description' => [ + 'description' => 'ECS 主机描述。', + 'type' => 'string', + 'example' => 'test', + ], + 'Disks' => [ + 'description' => '磁盘列表', + 'type' => 'array', + 'items' => [ + 'description' => '磁盘数据', + 'type' => 'object', + 'properties' => [ + 'DiskId' => [ + 'description' => '云盘或本地盘ID。', + 'type' => 'string', + 'example' => 'd-uf6aa8sjgtc4168f****', + ], + 'Category' => [ + 'description' => '磁盘类型。取值范围：'."\n" + .' - **cloud_efficiency**：高效云盘。'."\n" + .' - **cloud_ssd**：SSD云盘。'."\n" + .' - **cloud_essd**：ESSD云盘。'."\n" + .' - **cloud**：普通云盘。', + 'type' => 'string', + 'example' => 'cloud_essd', + ], + 'Type' => [ + 'description' => '云盘或本地盘磁盘类型 ，取值：'."\n" + ."\n" + .'- **system**：系统盘'."\n" + ."\n" + .'- **data**： 数据盘', + 'type' => 'string', + 'example' => 'system', + ], + 'Device' => [ + 'description' => '云盘或本地盘挂载实例的设备名。', + 'type' => 'string', + 'example' => '/dev/xvda', + ], + 'Mount' => [ + 'description' => '挂载目录。', + 'type' => 'string', + 'example' => '/data', + ], + ], + ], + ], + ], + ], + ], + 'MaxResults' => [ + 'description' => '> 该参数暂未上线，当前使用 PageNumber 与 PageSize 完成分页查询操作。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '50', + ], + 'NextToken' => [ + 'description' => '> 该参数暂未上线，当前使用 PageNumber 与 PageSize 完成分页查询操作。', + 'type' => 'string', + 'example' => 'caeba0bbb2be03f84eb48b699f0a4883', + ], + ], + ], + ], + ], + 'staticInfo' => [ + 'returnType' => 'synchronous', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22E****\\",\\n \\"PageSize\\": 20,\\n \\"PageNumber\\": 1,\\n \\"TotalCount\\": 100,\\n \\"InstanceList\\": [\\n {\\n \\"InstanceId\\": \\"i-2zeaquy5es02nksh****\\",\\n \\"VpcId\\": \\"vpc-uf6idhbqkbuw11kw3****\\",\\n \\"ZoneId\\": \\"cn-hangzhou-j\\",\\n \\"InstanceName\\": \\"launch-advisor-20250530\\",\\n \\"Stauts\\": \\"Running\\",\\n \\"IpList\\": [\\n {\\n \\"Ip\\": \\"127.0.0.1\\",\\n \\"Type\\": \\"Private\\"\\n }\\n ],\\n \\"SecurityGroups\\": [\\n \\"sg-uf66unlpw292cgh6****\\"\\n ],\\n \\"Description\\": \\"test\\",\\n \\"Disks\\": [\\n {\\n \\"DiskId\\": \\"d-uf6aa8sjgtc4168f****\\",\\n \\"Category\\": \\"cloud_essd\\",\\n \\"Type\\": \\"system\\",\\n \\"Device\\": \\"/dev/xvda\\",\\n \\"Mount\\": \\"/data\\"\\n }\\n ]\\n }\\n ],\\n \\"MaxResults\\": 50,\\n \\"NextToken\\": \\"caeba0bbb2be03f84eb48b699f0a4883\\"\\n}","type":"json"}]', + 'title' => '查询 ECS 实例列表', + ], + 'GetPrinsEventList' => [ + 'summary' => '获取事件列表。', + 'methods' => [ + 'get', + 'post', + ], + 'schemes' => [ + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '212752', + 'abilityTreeNodes' => [ + 'FEATUREcddcGJUHY1', + ], + ], + 'parameters' => [ + [ + 'name' => 'InstanceName', + 'in' => 'query', + 'schema' => [ + 'description' => '自建纳管实例的名称。', + 'type' => 'string', + 'required' => false, + 'example' => 'pr-22a21ac289e0****', + ], + ], + [ + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => [ + 'description' => '查询起始时间的时间戳。', + 'type' => 'string', + 'required' => false, + 'example' => '1732253446000', + ], + ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => [ + 'description' => '查询结束时间的时间戳。'."\n" + ."\n" + .'> StartTime 和 EndTime 之间的间隔不超过 12 小时', + 'type' => 'string', + 'required' => false, + 'example' => '1732255446000', + ], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'required' => false, + 'example' => 'cn-hangzhou', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'title' => 'Id of the request', + 'description' => '请求 ID。', + 'type' => 'string', + 'example' => 'C6592723-09E1-4248-A78E-12AB00D7****', + ], + 'EventList' => [ + 'description' => '事件列表。', + 'type' => 'array', + 'items' => [ + 'description' => '事件信息。', + 'type' => 'object', + 'properties' => [ + 'Name' => [ + 'description' => '事件名称。', + 'type' => 'string', + 'example' => 'Instance:StateChange', + ], + 'Content' => [ + 'description' => '事件描述。', + 'type' => 'string', + 'example' => '实例状态改变通知', + ], + 'Level' => [ + 'description' => '事件级别。取值：'."\n" + .'- Critical：严重。'."\n" + .'- Warn：警告。'."\n" + .'- Info：信息。', + 'type' => 'string', + 'example' => 'Info', + ], + 'Status' => [ + 'description' => '事件状态。', + 'type' => 'string', + 'example' => 'Normal', + ], + 'Time' => [ + 'description' => '事件发生的时间戳。', + 'type' => 'string', + 'example' => '1635993751000', + ], + ], + ], + ], + ], + ], + ], + ], + 'staticInfo' => [ + 'returnType' => 'synchronous', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C6592723-09E1-4248-A78E-12AB00D7****\\",\\n \\"EventList\\": [\\n {\\n \\"Name\\": \\"Instance:StateChange\\",\\n \\"Content\\": \\"实例状态改变通知\\",\\n \\"Level\\": \\"Info\\",\\n \\"Status\\": \\"Normal\\",\\n \\"Time\\": \\"1635993751000\\"\\n }\\n ]\\n}","type":"json"}]', + 'title' => '获取实例事件列表', + ], + 'GetPrinsMetricsList' => [ + 'summary' => '获取纳管实例性能指标数据。', + 'methods' => [ + 'get', + 'post', + ], + 'schemes' => [ + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '212752', + 'abilityTreeNodes' => [ + 'FEATUREcddcGJUHY1', + ], + ], + 'parameters' => [ + [ + 'name' => 'InstanceId', + 'in' => 'query', + 'schema' => [ + 'description' => 'ECS 实例 ID。', + 'type' => 'string', + 'required' => false, + 'example' => 'i-8vbgsaqkgzk9m24n****', + ], + ], + [ + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => [ + 'description' => '查询开始时间的时间戳。', + 'type' => 'string', + 'required' => false, + 'example' => '1732253446000', + ], + ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => [ + 'description' => '查询事件结束的时间戳。'."\n" + ."\n" + .'> StartTime 和 EndTime 之间的间隔不超过 12 小时', + 'type' => 'string', + 'required' => false, + 'example' => '1732255446000', + ], + ], + [ + 'name' => 'Metrics', + 'in' => 'query', + 'schema' => [ + 'description' => '指标信息。'."\n" + .'具体类别：'."\n" + ."\n" + .'**DAS**'."\n" + .'- mysql.tps,mysql.qps'."\n" + .'- mysql.threads_running,mysql.threads_connected,mysql.threads_created,mysql.threads_cached,mysql.threads_rejected'."\n" + .'- mysql.delete_ps,mysql.insert_ps,mysql.replace_ps,mysql.update_ps,mysql.select_ps'."\n" + .'- mysql.bytes_received,mysql.bytes_sent'."\n" + .'- mysql.innodb_bp_hit,mysql.innodb_bp_dirty_pct,mysql.innodb_bp_usage_pct'."\n" + .'- mysql.innodb_data_read,mysql.innodb_data_written'."\n" + .'- mysql.innodb_rows_read,mysql.innodb_rows_updated,mysql.innodb_rows_deleted,mysql.innodb_rows_inserted'."\n" + ."\n" + .'**ECS**'."\n" + ."\n" + .'- cpu_total'."\n" + .'- memory_usedutilization'."\n" + .'- load_1m,load_5m,load_15m'."\n" + .'- DiskReadBPS,DiskWriteBPS'."\n" + .'- DiskReadIOPS,DiskWriteIOPS'."\n" + .'- diskusage_utilization,fs_inodeutilization'."\n" + .'- VPC_PublicIP_InternetInRate,VPC_PublicIP_InternetOutRate'."\n" + .'- IntranetInRate,IntranetOutRate'."\n" + .'- concurrentConnections', + 'type' => 'string', + 'required' => false, + 'example' => 'cpu_total', + ], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '实例所在的[地域ID](~~198326~~)。', + 'type' => 'string', + 'required' => false, + 'example' => 'cn-hangzhou', + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => [ + 'title' => 'Id of the request', + 'description' => '请求 ID。', + 'type' => 'string', + 'example' => 'D6E068C3-25BC-455A-85FE-45F0B22E****', + ], + 'Data' => [ + 'description' => '返回指标数据列表。', + 'type' => 'array', + 'items' => [ + 'description' => '返回指标数据结果。', + 'type' => 'object', + 'properties' => [ + 'Kpi' => [ + 'description' => '指标名称。', + 'type' => 'string', + 'example' => 'cpu_total', + ], + 'Value' => [ + 'description' => '指标数值。', + 'type' => 'string', + 'example' => '50', + ], + 'Timestamp' => [ + 'description' => '指标统计时间戳。', + 'type' => 'string', + 'example' => '1732253446000', + ], + 'Category' => [ + 'description' => '指标的类型，取值：'."\n" + ."\n" + .'- DAS'."\n" + ."\n" + .'- ECS', + 'type' => 'string', + 'example' => 'ECS', + ], + ], + ], + ], + ], + ], + ], + ], + 'staticInfo' => [ + 'returnType' => 'synchronous', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22E****\\",\\n \\"Data\\": [\\n {\\n \\"Kpi\\": \\"cpu_total\\",\\n \\"Value\\": \\"50\\",\\n \\"Timestamp\\": \\"1732253446000\\",\\n \\"Category\\": \\"ECS\\"\\n }\\n ]\\n}","type":"json"}]', + 'title' => '获取实例性能指标', + ], + 'ListPrinsSQLErrorLog' => [ + 'summary' => '查询数据库错误日志。', + 'methods' => [ + 'get', + 'post', + ], + 'schemes' => [ + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '227820', + 'abilityTreeNodes' => [ + 'FEATUREcddc7QNOWM', + ], + ], + 'parameters' => [ + [ + 'name' => 'InstanceName', + 'in' => 'query', + 'schema' => [ + 'description' => '自建纳管实例的名称', + 'type' => 'string', + 'required' => true, + 'example' => 'pr-22a21ac289e0****', + ], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'required' => true, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'Keyword', + 'in' => 'query', + 'schema' => [ + 'description' => '日志查询关键字。', + 'type' => 'string', + 'required' => false, + 'example' => 'keyword', + ], + ], + [ + 'name' => 'StartLinenum', + 'in' => 'query', + 'schema' => [ + 'description' => '指定内容获取的开始行号，为0时表示获取最新的日志内容，默认值0。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '0', + ], + ], + [ + 'name' => 'Size', + 'in' => 'query', + 'schema' => [ + 'description' => '查询的日志条数，默认30。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '30', + ], + ], + [ + 'name' => 'Reverse', + 'in' => 'query', + 'schema' => [ + 'description' => '是否正序查询，默认为false。'."\n" + ."\n" + .'- true: 表示从 StartLinenum 开始向上获取 Size 条日志内容，即返回 (StartLinenum - Size, StartLinenum) 区间内的数据。'."\n" + .'- false: 表示从 StartLinenum 开始向下获取 Size 条日志内容，即返回 (StartLinenum, StartLinenum+Size) 区间内的数据。', + 'type' => 'boolean', + 'required' => false, + 'example' => 'false', + ], + ], + [ + 'name' => 'LogPath', + 'in' => 'query', + 'schema' => [ + 'description' => '日志所在路径，为空时会自动获取 mysql 错误日志位置。', + 'type' => 'string', + 'required' => false, + 'example' => 'error.log', + ], + ], + ], + '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' => 'B74AD197-214C-50F2-BF7D-B13632EE****', + ], + 'LogList' => [ + 'description' => '返回日志的信息列表。', + 'type' => 'array', + 'items' => [ + 'description' => '日志内容。', + 'type' => 'object', + 'properties' => [ + 'Content' => [ + 'description' => '日志内容。', + 'type' => 'string', + 'example' => 'error: ****', + ], + 'Linenum' => [ + 'description' => '行号。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '1', + ], + ], + ], + ], + 'TotalCount' => [ + 'description' => '查询地域下实例总数。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '1', + ], + 'LogPath' => [ + 'description' => '日志路径，指定要收集的日志所在路径', + 'type' => 'string', + 'example' => 'error.log', + ], + ], + ], + ], + ], + 'staticInfo' => [ + 'returnType' => 'synchronous', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"B74AD197-214C-50F2-BF7D-B13632EE****\\",\\n \\"LogList\\": [\\n {\\n \\"Content\\": \\"error: ****\\",\\n \\"Linenum\\": 1\\n }\\n ],\\n \\"TotalCount\\": 1,\\n \\"LogPath\\": \\"error.log\\"\\n}","type":"json"}]', + 'title' => '查询数据库错误日志', + ], + 'ListPrinsParams' => [ + 'summary' => '查询数据库纳管实例参数列表。', + 'methods' => [ + 'post', + 'get', + ], + 'schemes' => [ + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '227820', + 'abilityTreeNodes' => [ + 'FEATUREcddc7QNOWM', + ], + ], + 'parameters' => [ + [ + 'name' => 'InstanceName', + 'in' => 'query', + 'schema' => [ + 'description' => '自建纳管实例的名称', + 'type' => 'string', + 'required' => true, + 'example' => 'pr-22a21ac289e0****', + ], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '地域ID。可调用[DescribeRegions](~~214103~~)获取。', + 'type' => 'string', + 'required' => false, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'ConfigName', + 'in' => 'query', + 'schema' => [ + 'description' => '参数配置名称，模糊匹配规则。', + 'type' => 'string', + 'required' => false, + 'example' => 'innodb', + ], + ], + [ + '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', + ], + ], + ], + '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' => 'C860658E-68A6-46C1-AF6E-3AE7C4D3****', + ], + 'ConfigList' => [ + 'description' => '参数信息列表。', + 'type' => 'array', + 'items' => [ + 'description' => '参数信息。', + 'type' => 'object', + 'properties' => [ + 'ConfigName' => [ + 'description' => '参数名称。', + 'type' => 'string', + 'example' => 'innodb_buffer_pool_size', + ], + 'DefaultValue' => [ + 'description' => '参数默认值。', + 'type' => 'string', + 'example' => '128134217728', + ], + 'CurValue' => [ + 'description' => '参数当前值。', + 'type' => 'string', + 'example' => '134217728', + ], + 'Comment' => [ + 'description' => '参数的具体英文含义。', + 'type' => 'string', + 'example' => 'InnoDB buffer pool size。', + ], + 'Translation' => [ + 'description' => '参数的中文含义。', + 'type' => 'string', + 'example' => 'InnoDB 缓冲池的大小。', + ], + ], + ], + ], + 'PageSize' => [ + 'description' => '每页展示数目。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '30', + ], + 'PageNumber' => [ + 'description' => '分页页码，从1开始。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '1', + ], + 'TotalCount' => [ + 'description' => '总记录条数。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '100', + ], + ], + ], + ], + ], + 'staticInfo' => [ + 'returnType' => 'synchronous', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C860658E-68A6-46C1-AF6E-3AE7C4D3****\\",\\n \\"ConfigList\\": [\\n {\\n \\"ConfigName\\": \\"innodb_buffer_pool_size\\",\\n \\"DefaultValue\\": \\"128134217728\\",\\n \\"CurValue\\": \\"134217728\\",\\n \\"Comment\\": \\"InnoDB buffer pool size。\\",\\n \\"Translation\\": \\"InnoDB 缓冲池的大小。\\"\\n }\\n ],\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"TotalCount\\": 100\\n}","type":"json"}]', + 'title' => '查询数据库参数列表', + ], + 'ListPrinsInstances' => [ + 'summary' => '查询纳管实例列表。', + 'methods' => [ + 'get', + 'post', + ], + 'schemes' => [ + 'https', + ], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '212746', + 'abilityTreeNodes' => [ + 'FEATUREcddcGJUHY1', + ], + 'tenantRelevance' => 'publicInformation', + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => [ + 'description' => '地域ID。可查看[地域信息](~~198326~~)获取。', + 'type' => 'string', + 'required' => false, + 'example' => 'cn-hangzhou', + ], + ], + [ + 'name' => 'InstanceName', + 'in' => 'query', + 'schema' => [ + 'description' => '自建纳管实例的名称。', + 'type' => 'string', + 'required' => false, + 'example' => 'pr-22a21ac289e0****', + ], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => [ + 'description' => '每页展示数目。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '30', + ], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => [ + 'description' => '实例列表的页码，起始值为1，默认值为1。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'example' => '1', + ], + ], + [ + 'name' => 'EngineType', + 'in' => 'query', + 'schema' => [ + 'description' => '引擎类型，取值：'."\n" + .'- **MySQL** 。', + 'type' => 'string', + 'required' => false, + 'example' => 'MySQL', + ], + ], + [ + 'name' => 'Tag', + 'in' => 'query', + 'allowEmptyValue' => false, + 'style' => 'json', + 'schema' => [ + 'description' => '标签信息，筛选出包含对应标签键值的实例。', + 'type' => 'array', + 'items' => [ + 'description' => '标签。', + 'type' => 'object', + 'properties' => [ + 'Key' => [ + 'description' => '标签的键。', + 'type' => 'string', + 'required' => false, + 'example' => 'demokey', + ], + 'Value' => [ + 'description' => '标签的值。', + 'type' => 'string', + 'required' => false, + 'example' => 'demovalue', + ], + ], + 'required' => false, + ], + 'required' => false, + ], + ], + [ + 'name' => 'MaxResults', + 'in' => 'query', + 'schema' => [ + 'description' => '> 该参数暂未上线，当前使用 PageNumber 与 PageSize 完成分页查询操作。', + 'type' => 'integer', + 'format' => 'int32', + 'required' => false, + 'maximum' => '100', + 'minimum' => '0', + 'example' => '20', + ], + ], + [ + 'name' => 'NextToken', + 'in' => 'query', + 'schema' => [ + 'description' => '> 该参数暂未上线，当前使用 PageNumber 与 PageSize 完成分页查询操作。', + 'type' => 'string', + 'required' => false, + 'example' => 'caeba0bbb2be03f84eb48b699f0a4883', + ], + ], + [ + 'name' => 'EngineVersion', + 'in' => 'query', + 'schema' => [ + 'description' => '数据库版本。', + 'type' => 'string', + 'required' => false, + 'example' => '8.0.36', + ], + ], + ], + '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' => 'D6E068C3-25BC-455A-85FE-45F0B22****', + ], + 'PageSize' => [ + 'description' => '每页展示数目。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '30', + ], + 'PageNumber' => [ + 'description' => '页码', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '1', + ], + 'TotalCount' => [ + 'description' => '总记录条数', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '100', + ], + 'Instances' => [ + 'description' => '实例信息列表。', + 'type' => 'array', + 'items' => [ + 'description' => '实例信息。', + 'type' => 'object', + 'properties' => [ + 'RegionId' => [ + 'description' => '主机所属的地域 ID。', + 'type' => 'string', + 'example' => 'cn-hangzhou', + ], + 'Status' => [ + 'description' => '实例状态描述。', + 'type' => 'string', + 'enumValueTitles' => [ + 'inactive' => '异常', + 'deleted' => '已删除', + 'creating' => '创建中', + 'active' => '运行中', + ], + 'example' => 'active', + ], + 'InstanceName' => [ + 'description' => '自建纳管实例名称。', + 'type' => 'string', + 'example' => 'pr-22a21ac289e0****', + ], + 'Alias' => [ + 'description' => '实例别名。', + 'type' => 'string', + 'example' => 'test', + ], + 'EngineType' => [ + 'description' => '引擎类型，取值：'."\n" + .'- **MySQL** 。', + 'type' => 'string', + 'example' => 'MySQL', + ], + 'EngineVersion' => [ + 'description' => '数据库版本。', + 'type' => 'string', + 'example' => '8.0.36', + ], + 'GmtCreated' => [ + 'description' => '实例创建时间的时间戳。', + 'type' => 'string', + 'example' => '1729758903000', + ], + 'Description' => [ + 'description' => '实例描述。', + 'type' => 'string', + 'example' => 'test', + ], + 'Tag' => [ + 'description' => '标签列表。', + 'type' => 'array', + 'items' => [ + 'description' => '标签信息。', + 'type' => 'object', + 'properties' => [ + 'Key' => [ + 'description' => '标签的键。', + 'type' => 'string', + 'example' => 'key', + ], + 'Value' => [ + 'description' => '标签的值。', + 'type' => 'string', + 'example' => 'value', + ], + ], + ], + ], + 'DmsId' => [ + 'description' => '实例关联的 dms 实例 id。', + 'type' => 'string', + 'example' => '2717906', + ], + 'DasId' => [ + 'description' => '实例关联的 das 实例 id。', + 'type' => 'string', + 'example' => 'hdm_ef2263e117f23c4f3114417742b****', + ], + 'Vip' => [ + 'description' => '实例的 ip。', + 'type' => 'boolean', + 'example' => '127.0.0.1', + ], + ], + ], + ], + 'MaxResults' => [ + 'description' => '> 该参数暂未上线，当前使用 PageNumber 与 PageSize 完成分页查询操作。'."\n" + ."\n" + .'使用NextToken方式查询时，每次最多返回的结果数。', + 'type' => 'integer', + 'format' => 'int32', + 'example' => '100', + ], + 'NextToken' => [ + 'description' => '> 该参数暂未上线，当前使用 PageNumber 与 PageSize 完成分页查询操作。'."\n" + ."\n" + .'本次调用返回的查询凭证值。', + 'type' => 'string', + 'example' => '4b1e854bca4f2fb7e0b5e8707e68181f', + ], + ], + ], + ], + ], + 'staticInfo' => [ + 'returnType' => 'synchronous', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D6E068C3-25BC-455A-85FE-45F0B22****\\",\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"TotalCount\\": 100,\\n \\"Instances\\": [\\n {\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"Status\\": \\"active\\",\\n \\"InstanceName\\": \\"pr-22a21ac289e0****\\",\\n \\"Alias\\": \\"test\\",\\n \\"EngineType\\": \\"MySQL\\",\\n \\"EngineVersion\\": \\"8.0.36\\",\\n \\"GmtCreated\\": \\"1729758903000\\",\\n \\"Description\\": \\"test\\",\\n \\"Tag\\": [\\n {\\n \\"Key\\": \\"key\\",\\n \\"Value\\": \\"value\\"\\n }\\n ],\\n \\"DmsId\\": \\"2717906\\",\\n \\"DasId\\": \\"hdm_ef2263e117f23c4f3114417742b****\\",\\n \\"Vip\\": true\\n }\\n ],\\n \\"MaxResults\\": 100,\\n \\"NextToken\\": \\"4b1e854bca4f2fb7e0b5e8707e68181f\\"\\n}","type":"json"}]', + 'title' => '查询纳管实例列表', + ], + ], + 'endpoints' => [ + [ + 'regionId' => 'cn-shenzhen', + 'endpoint' => 'cddc.aliyuncs.com', + ], + [ + 'regionId' => 'cn-qingdao', + 'endpoint' => 'cddc.aliyuncs.com', + ], + [ + 'regionId' => 'cn-beijing', + 'endpoint' => 'cddc.aliyuncs.com', + ], + [ + 'regionId' => 'cn-zhangjiakou', + 'endpoint' => 'cddc.cn-zhangjiakou.aliyuncs.com', + ], + [ + 'regionId' => 'cn-huhehaote', + 'endpoint' => 'cddc.cn-huhehaote.aliyuncs.com', + ], + [ + 'regionId' => 'cn-hangzhou', + 'endpoint' => 'cddc.aliyuncs.com', + ], + [ + 'regionId' => 'cn-shanghai', + 'endpoint' => 'cddc.aliyuncs.com', + ], + [ + 'regionId' => 'cn-heyuan', + 'endpoint' => 'cddc.aliyuncs.com', + ], + [ + 'regionId' => 'cn-chengdu', + 'endpoint' => 'cddc.cn-chengdu.aliyuncs.com', + ], + [ + 'regionId' => 'cn-hongkong', + 'endpoint' => 'cddc.aliyuncs.com', + ], + [ + 'regionId' => 'ap-northeast-1', + 'endpoint' => 'cddc.ap-northeast-1.aliyuncs.com', + ], + [ + 'regionId' => 'ap-southeast-1', + 'endpoint' => 'cddc.aliyuncs.com', + ], + [ + 'regionId' => 'ap-southeast-2', + 'endpoint' => 'cddc.ap-southeast-2.aliyuncs.com', + ], + [ + 'regionId' => 'ap-southeast-3', + 'endpoint' => 'cddc.ap-southeast-3.aliyuncs.com', + ], + [ + 'regionId' => 'ap-southeast-5', + 'endpoint' => 'cddc.ap-southeast-5.aliyuncs.com', + ], + [ + 'regionId' => 'us-east-1', + 'endpoint' => 'cddc.aliyuncs.com', + ], + [ + 'regionId' => 'us-west-1', + 'endpoint' => 'cddc.aliyuncs.com', + ], + [ + 'regionId' => 'eu-west-1', + 'endpoint' => 'cddc.eu-west-1.aliyuncs.com', + ], + [ + 'regionId' => 'eu-central-1', + 'endpoint' => 'cddc.eu-central-1.aliyuncs.com', + ], + [ + 'regionId' => 'me-east-1', + 'endpoint' => 'cddc.me-east-1.aliyuncs.com', + ], + [ + 'regionId' => 'cn-shanghai-finance-1', + 'endpoint' => 'cddc.aliyuncs.com', + ], + [ + 'regionId' => 'cn-shenzhen-finance-1', + 'endpoint' => 'cddc.aliyuncs.com', + ], + [ + 'regionId' => 'ap-south-1', + 'endpoint' => 'cddc.ap-south-1.aliyuncs.com', + ], + ], +]; -- cgit v1.2.3