tencentcloud-sdk-python 3.0.1408__py2.py3-none-any.whl → 3.0.1410__py2.py3-none-any.whl

tencentcloud/cdb/v20170320/models.py

@@ -25,9 +25,12 @@ class Account(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _User: 新账户的名称
+        :param _User: 账号名，可输入1 - 32个字符。
         :type User: str
-        :param _Host: 新账户的域名
+        :param _Host: 账号的主机。
+说明：
+1. IP 形式，支持填入%。
+2. 多个主机以分隔符分隔，分隔符支持;,|换行符和空格。
         :type Host: str
         """
         self._User = None
@@ -35,7 +38,7 @@ class Account(AbstractModel):
 
     @property
     def User(self):
-        """新账户的名称
+        """账号名，可输入1 - 32个字符。
         :rtype: str
         """
         return self._User
@@ -46,7 +49,10 @@ class Account(AbstractModel):
 
     @property
     def Host(self):
-        """新账户的域名
+        """账号的主机。
+说明：
+1. IP 形式，支持填入%。
+2. 多个主机以分隔符分隔，分隔符支持;,|换行符和空格。
         :rtype: str
         """
         return self._Host
@@ -531,16 +537,17 @@ class AdjustCdbProxyAddressRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _ProxyGroupId: 代理组ID
+        :param _ProxyGroupId: 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyGroupId: str
         :param _WeightMode: 权重分配模式，
 系统自动分配："system"， 自定义："custom"
         :type WeightMode: str
         :param _IsKickOut: 是否开启延迟剔除，取值："true" | "false"
         :type IsKickOut: bool
-        :param _MinCount: 最小保留数量，最小取值：0
+        :param _MinCount: 最小保留数量，最小取值：0。
+说明：当 IsKickOut 为 true 时才有效。
         :type MinCount: int
-        :param _MaxDelay: 延迟剔除阈值，最小取值：0
+        :param _MaxDelay: 延迟剔除阈值，最小取值：1，取值范围：[1,10000]，整数。
         :type MaxDelay: int
         :param _FailOver: 是否开启故障转移，取值："true" | "false"
         :type FailOver: bool
@@ -548,18 +555,18 @@ class AdjustCdbProxyAddressRequest(AbstractModel):
         :type AutoAddRo: bool
         :param _ReadOnly: 是否是只读，取值："true" | "false"
         :type ReadOnly: bool
-        :param _ProxyAddressId: 代理组地址ID
+        :param _ProxyAddressId: 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyAddressId: str
-        :param _TransSplit: 是否开启事务分离，取值："true" | "false"
+        :param _TransSplit: 是否开启事务分离，取值："true" | "false"，默认值 false。
         :type TransSplit: bool
-        :param _ConnectionPool: 是否开启连接池
+        :param _ConnectionPool: 是否开启连接池。默认关闭。
 注意：如需使用数据库代理连接池能力，MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。
         :type ConnectionPool: bool
         :param _ProxyAllocation: 读写权重分配。如果 WeightMode 传的是 system ，则传入的权重不生效，由系统分配默认权重。
         :type ProxyAllocation: list of ProxyAllocation
-        :param _AutoLoadBalance: 是否开启自适应负载均衡
+        :param _AutoLoadBalance: 是否开启自适应负载均衡。默认关闭。
         :type AutoLoadBalance: bool
-        :param _AccessMode: 访问模式：就近访问，均衡分配
+        :param _AccessMode: 访问模式：nearby - 就近访问，balance - 均衡分配，默认就近访问。
         :type AccessMode: str
         """
         self._ProxyGroupId = None
@@ -579,7 +586,7 @@ class AdjustCdbProxyAddressRequest(AbstractModel):
 
     @property
     def ProxyGroupId(self):
-        """代理组ID
+        """代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyGroupId
@@ -613,7 +620,8 @@ class AdjustCdbProxyAddressRequest(AbstractModel):
 
     @property
     def MinCount(self):
-        """最小保留数量，最小取值：0
+        """最小保留数量，最小取值：0。
+说明：当 IsKickOut 为 true 时才有效。
         :rtype: int
         """
         return self._MinCount
@@ -624,7 +632,7 @@ class AdjustCdbProxyAddressRequest(AbstractModel):
 
     @property
     def MaxDelay(self):
-        """延迟剔除阈值，最小取值：0
+        """延迟剔除阈值，最小取值：1，取值范围：[1,10000]，整数。
         :rtype: int
         """
         return self._MaxDelay
@@ -668,7 +676,7 @@ class AdjustCdbProxyAddressRequest(AbstractModel):
 
     @property
     def ProxyAddressId(self):
-        """代理组地址ID
+        """代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyAddressId
@@ -679,7 +687,7 @@ class AdjustCdbProxyAddressRequest(AbstractModel):
 
     @property
     def TransSplit(self):
-        """是否开启事务分离，取值："true" | "false"
+        """是否开启事务分离，取值："true" | "false"，默认值 false。
         :rtype: bool
         """
         return self._TransSplit
@@ -690,7 +698,7 @@ class AdjustCdbProxyAddressRequest(AbstractModel):
 
     @property
     def ConnectionPool(self):
-        """是否开启连接池
+        """是否开启连接池。默认关闭。
 注意：如需使用数据库代理连接池能力，MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。
         :rtype: bool
         """
@@ -713,7 +721,7 @@ class AdjustCdbProxyAddressRequest(AbstractModel):
 
     @property
     def AutoLoadBalance(self):
-        """是否开启自适应负载均衡
+        """是否开启自适应负载均衡。默认关闭。
         :rtype: bool
         """
         return self._AutoLoadBalance
@@ -724,7 +732,7 @@ class AdjustCdbProxyAddressRequest(AbstractModel):
 
     @property
     def AccessMode(self):
-        """访问模式：就近访问，均衡分配
+        """访问模式：nearby - 就近访问，balance - 均衡分配，默认就近访问。
         :rtype: str
         """
         return self._AccessMode
@@ -814,9 +822,9 @@ class AdjustCdbProxyRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例ID
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
-        :param _ProxyGroupId: 代理组ID
+        :param _ProxyGroupId: 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyGroupId: str
         :param _ProxyNodeCustom: 节点规格配置
 备注：数据库代理支持的节点规格为：2C4000MB、4C8000MB、8C16000MB。
@@ -840,7 +848,7 @@ Mem：单个代理节点内存数（单位：MB）
 
     @property
     def InstanceId(self):
-        """实例ID
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -851,7 +859,7 @@ Mem：单个代理节点内存数（单位：MB）
 
     @property
     def ProxyGroupId(self):
-        """代理组ID
+        """代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyGroupId
@@ -1179,7 +1187,7 @@ class AnalyzeAuditLogsRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例ID。
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
         :param _StartTime: 要分析的日志开始时间，格式为："2023-02-16 00:00:20"。
         :type StartTime: str
@@ -1201,7 +1209,7 @@ class AnalyzeAuditLogsRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """实例ID。
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -5424,14 +5432,14 @@ class CloseAuditServiceRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例ID。
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
         """
         self._InstanceId = None
 
     @property
     def InstanceId(self):
-        """实例ID。
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -5488,9 +5496,9 @@ class CloseCDBProxyRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例ID
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
-        :param _ProxyGroupId: 代理组ID
+        :param _ProxyGroupId: 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyGroupId: str
         :param _OnlyCloseRW: 是否只关闭读写分离，取值："true" | "false"，默认为"false"
         :type OnlyCloseRW: bool
@@ -5501,7 +5509,7 @@ class CloseCDBProxyRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """实例ID
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -5512,7 +5520,7 @@ class CloseCDBProxyRequest(AbstractModel):
 
     @property
     def ProxyGroupId(self):
-        """代理组ID
+        """代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyGroupId
@@ -5582,9 +5590,9 @@ class CloseCdbProxyAddressRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _ProxyGroupId: 代理组ID
+        :param _ProxyGroupId: 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyGroupId: str
-        :param _ProxyAddressId: 代理组地址ID
+        :param _ProxyAddressId: 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyAddressId: str
         """
         self._ProxyGroupId = None
@@ -5592,7 +5600,7 @@ class CloseCdbProxyAddressRequest(AbstractModel):
 
     @property
     def ProxyGroupId(self):
-        """代理组ID
+        """代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyGroupId
@@ -5603,7 +5611,7 @@ class CloseCdbProxyAddressRequest(AbstractModel):
 
     @property
     def ProxyAddressId(self):
-        """代理组地址ID
+        """代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyAddressId
@@ -5661,9 +5669,9 @@ class CloseSSLRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例 ID 。只读组 ID为空时必填。
+        :param _InstanceId: 实例 ID。只读组 ID 为空时必填。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
-        :param _RoGroupId: 只读组 ID。实例 ID为空时必填。
+        :param _RoGroupId: 只读组 ID。实例 ID 为空时必填。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。
         :type RoGroupId: str
         """
         self._InstanceId = None
@@ -5671,7 +5679,7 @@ class CloseSSLRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """实例 ID 。只读组 ID为空时必填。
+        """实例 ID。只读组 ID 为空时必填。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -5682,7 +5690,7 @@ class CloseSSLRequest(AbstractModel):
 
     @property
     def RoGroupId(self):
-        """只读组 ID。实例 ID为空时必填。
+        """只读组 ID。实例 ID 为空时必填。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。
         :rtype: str
         """
         return self._RoGroupId
@@ -6933,15 +6941,15 @@ class CreateAuditRuleTemplateRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _RuleFilters: 审计规则
+        :param _RuleFilters: 审计规则。
         :type RuleFilters: list of RuleFilters
-        :param _RuleTemplateName: 规则模板名称
+        :param _RuleTemplateName: 规则模板名称。最多支持输入30个字符。
         :type RuleTemplateName: str
-        :param _Description: 规则模板描述
+        :param _Description: 规则模板描述。最多支持输入200个字符。
         :type Description: str
-        :param _AlarmLevel: 告警等级。1-低风险，2-中风险，3-高风险
+        :param _AlarmLevel: 告警等级。1 - 低风险，2 - 中风险，3 - 高风险。默认值为1。
         :type AlarmLevel: int
-        :param _AlarmPolicy: 告警策略。0-不告警，1-告警
+        :param _AlarmPolicy: 告警策略。0 - 不告警，1 - 告警。默认值为0。
         :type AlarmPolicy: int
         """
         self._RuleFilters = None
@@ -6952,7 +6960,7 @@ class CreateAuditRuleTemplateRequest(AbstractModel):
 
     @property
     def RuleFilters(self):
-        """审计规则
+        """审计规则。
         :rtype: list of RuleFilters
         """
         return self._RuleFilters
@@ -6963,7 +6971,7 @@ class CreateAuditRuleTemplateRequest(AbstractModel):
 
     @property
     def RuleTemplateName(self):
-        """规则模板名称
+        """规则模板名称。最多支持输入30个字符。
         :rtype: str
         """
         return self._RuleTemplateName
@@ -6974,7 +6982,7 @@ class CreateAuditRuleTemplateRequest(AbstractModel):
 
     @property
     def Description(self):
-        """规则模板描述
+        """规则模板描述。最多支持输入200个字符。
         :rtype: str
         """
         return self._Description
@@ -6985,7 +6993,7 @@ class CreateAuditRuleTemplateRequest(AbstractModel):
 
     @property
     def AlarmLevel(self):
-        """告警等级。1-低风险，2-中风险，3-高风险
+        """告警等级。1 - 低风险，2 - 中风险，3 - 高风险。默认值为1。
         :rtype: int
         """
         return self._AlarmLevel
@@ -6996,7 +7004,7 @@ class CreateAuditRuleTemplateRequest(AbstractModel):
 
     @property
     def AlarmPolicy(self):
-        """告警策略。0-不告警，1-告警
+        """告警策略。0 - 不告警，1 - 告警。默认值为0。
         :rtype: int
         """
         return self._AlarmPolicy
@@ -7223,7 +7231,7 @@ class CreateCdbProxyAddressRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _ProxyGroupId: 代理组ID
+        :param _ProxyGroupId: 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyGroupId: str
         :param _WeightMode: 权重分配模式，
 系统自动分配："system"， 自定义："custom"
@@ -7232,7 +7240,7 @@ class CreateCdbProxyAddressRequest(AbstractModel):
         :type IsKickOut: bool
         :param _MinCount: 最小保留数量，最小取值：0
         :type MinCount: int
-        :param _MaxDelay: 延迟剔除阈值，最小取值：0
+        :param _MaxDelay: 延迟剔除阈值，最小取值：1，范围：1 - 10000，整数。
         :type MaxDelay: int
         :param _FailOver: 是否开启故障转移，取值："true" | "false"
         :type FailOver: bool
@@ -7244,26 +7252,26 @@ class CreateCdbProxyAddressRequest(AbstractModel):
         :type TransSplit: bool
         :param _ProxyAllocation: 读写权重分配
         :type ProxyAllocation: list of ProxyAllocation
-        :param _UniqVpcId: 私有网络ID
+        :param _UniqVpcId: 私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type UniqVpcId: str
-        :param _UniqSubnetId: 私有子网ID
+        :param _UniqSubnetId: 私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type UniqSubnetId: str
-        :param _ConnectionPool: 是否开启连接池
+        :param _ConnectionPool: 是否开启连接池。默认关闭。
 注意：如需使用数据库代理连接池能力，MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。
         :type ConnectionPool: bool
         :param _Desc: 描述
         :type Desc: str
-        :param _Vip: IP地址
+        :param _Vip: IP 地址。不填则默认为所选 VPC 下支持的随机一个 IP。
         :type Vip: str
-        :param _VPort: 端口
+        :param _VPort: 端口。默认值3306。
         :type VPort: int
         :param _SecurityGroup: 安全组
         :type SecurityGroup: list of str
-        :param _ConnectionPoolType: 连接池类型。可选值 transaction（事务级别连接池），connection（会话级别连接池），ConnectionPool为true时生效。
+        :param _ConnectionPoolType: 连接池类型。可选值 transaction（事务级别连接池），connection（会话级别连接池），ConnectionPool 为 true 时生效。默认值：connection。
         :type ConnectionPoolType: str
-        :param _AutoLoadBalance: 是否自适应负载均衡
+        :param _AutoLoadBalance: 是否开启自适应负载均衡。默认关闭。
         :type AutoLoadBalance: bool
-        :param _AccessMode: 接入模式
+        :param _AccessMode: 接入模式。nearBy - 就近访问，balance - 均衡分配，默认值：nearBy。
         :type AccessMode: str
         """
         self._ProxyGroupId = None
@@ -7289,7 +7297,7 @@ class CreateCdbProxyAddressRequest(AbstractModel):
 
     @property
     def ProxyGroupId(self):
-        """代理组ID
+        """代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyGroupId
@@ -7334,7 +7342,7 @@ class CreateCdbProxyAddressRequest(AbstractModel):
 
     @property
     def MaxDelay(self):
-        """延迟剔除阈值，最小取值：0
+        """延迟剔除阈值，最小取值：1，范围：1 - 10000，整数。
         :rtype: int
         """
         return self._MaxDelay
@@ -7400,7 +7408,7 @@ class CreateCdbProxyAddressRequest(AbstractModel):
 
     @property
     def UniqVpcId(self):
-        """私有网络ID
+        """私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._UniqVpcId
@@ -7411,7 +7419,7 @@ class CreateCdbProxyAddressRequest(AbstractModel):
 
     @property
     def UniqSubnetId(self):
-        """私有子网ID
+        """私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._UniqSubnetId
@@ -7422,7 +7430,7 @@ class CreateCdbProxyAddressRequest(AbstractModel):
 
     @property
     def ConnectionPool(self):
-        """是否开启连接池
+        """是否开启连接池。默认关闭。
 注意：如需使用数据库代理连接池能力，MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。
         :rtype: bool
         """
@@ -7445,7 +7453,7 @@ class CreateCdbProxyAddressRequest(AbstractModel):
 
     @property
     def Vip(self):
-        """IP地址
+        """IP 地址。不填则默认为所选 VPC 下支持的随机一个 IP。
         :rtype: str
         """
         return self._Vip
@@ -7456,7 +7464,7 @@ class CreateCdbProxyAddressRequest(AbstractModel):
 
     @property
     def VPort(self):
-        """端口
+        """端口。默认值3306。
         :rtype: int
         """
         return self._VPort
@@ -7478,7 +7486,7 @@ class CreateCdbProxyAddressRequest(AbstractModel):
 
     @property
     def ConnectionPoolType(self):
-        """连接池类型。可选值 transaction（事务级别连接池），connection（会话级别连接池），ConnectionPool为true时生效。
+        """连接池类型。可选值 transaction（事务级别连接池），connection（会话级别连接池），ConnectionPool 为 true 时生效。默认值：connection。
         :rtype: str
         """
         return self._ConnectionPoolType
@@ -7489,7 +7497,7 @@ class CreateCdbProxyAddressRequest(AbstractModel):
 
     @property
     def AutoLoadBalance(self):
-        """是否自适应负载均衡
+        """是否开启自适应负载均衡。默认关闭。
         :rtype: bool
         """
         return self._AutoLoadBalance
@@ -7500,7 +7508,7 @@ class CreateCdbProxyAddressRequest(AbstractModel):
 
     @property
     def AccessMode(self):
-        """接入模式
+        """接入模式。nearBy - 就近访问，balance - 均衡分配，默认值：nearBy。
         :rtype: str
         """
         return self._AccessMode
@@ -7596,11 +7604,11 @@ class CreateCdbProxyRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例ID
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
-        :param _UniqVpcId: 私有网络ID
+        :param _UniqVpcId: 私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type UniqVpcId: str
-        :param _UniqSubnetId: 私有子网ID
+        :param _UniqSubnetId: 私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type UniqSubnetId: str
         :param _ProxyNodeCustom: 节点规格配置。
 示例中参数说明：
@@ -7634,7 +7642,7 @@ Mem：单个代理节点内存数（单位：MB）。
 
     @property
     def InstanceId(self):
-        """实例ID
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -7645,7 +7653,7 @@ Mem：单个代理节点内存数（单位：MB）。
 
     @property
     def UniqVpcId(self):
-        """私有网络ID
+        """私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._UniqVpcId
@@ -7656,7 +7664,7 @@ Mem：单个代理节点内存数（单位：MB）。
 
     @property
     def UniqSubnetId(self):
-        """私有子网ID
+        """私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._UniqSubnetId
@@ -10879,9 +10887,9 @@ class DeleteAuditLogFileRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _FileName: 审计日志文件名称。
+        :param _FileName: 审计日志文件名称。可通过 [DescribeAuditLogFiles](https://cloud.tencent.com/document/api/236/45454) 接口获取。
         :type FileName: str
-        :param _InstanceId: 实例 ID。
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
         """
         self._FileName = None
@@ -10889,7 +10897,7 @@ class DeleteAuditLogFileRequest(AbstractModel):
 
     @property
     def FileName(self):
-        """审计日志文件名称。
+        """审计日志文件名称。可通过 [DescribeAuditLogFiles](https://cloud.tencent.com/document/api/236/45454) 接口获取。
         :rtype: str
         """
         return self._FileName
@@ -10900,7 +10908,7 @@ class DeleteAuditLogFileRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """实例 ID。
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -11782,9 +11790,9 @@ class DescribeAccountPrivilegesRequest(AbstractModel):
         r"""
         :param _InstanceId: 实例 ID，格式如：cdb-c1nl9rpv，与云数据库控制台页面中显示的实例 ID 相同。
         :type InstanceId: str
-        :param _User: 数据库的账号名称。
+        :param _User: 数据库的账号名称。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。
         :type User: str
-        :param _Host: 数据库的账号域名。
+        :param _Host: 数据库的账号域名。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。
         :type Host: str
         """
         self._InstanceId = None
@@ -11804,7 +11812,7 @@ class DescribeAccountPrivilegesRequest(AbstractModel):
 
     @property
     def User(self):
-        """数据库的账号名称。
+        """数据库的账号名称。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。
         :rtype: str
         """
         return self._User
@@ -11815,7 +11823,7 @@ class DescribeAccountPrivilegesRequest(AbstractModel):
 
     @property
     def Host(self):
-        """数据库的账号域名。
+        """数据库的账号域名。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。
         :rtype: str
         """
         return self._Host
@@ -12494,7 +12502,7 @@ class DescribeAuditLogFilesRequest(AbstractModel):
         r"""
         :param _InstanceId: 实例 ID，格式如：cdb-c1nl9rpv 或者 cdbro-c1nl9rpv，与云数据库控制台页面中显示的实例 ID 相同。
         :type InstanceId: str
-        :param _Limit: 分页大小参数。默认值为 20，最小值为 1，最大值为 100。
+        :param _Limit: 分页大小参数。默认值为20，最小值为1，最大值为300。
         :type Limit: int
         :param _Offset: 分页偏移量。
         :type Offset: int
@@ -12519,7 +12527,7 @@ class DescribeAuditLogFilesRequest(AbstractModel):
 
     @property
     def Limit(self):
-        """分页大小参数。默认值为 20，最小值为 1，最大值为 100。
+        """分页大小参数。默认值为20，最小值为1，最大值为300。
         :rtype: int
         """
         return self._Limit
@@ -13222,7 +13230,7 @@ class DescribeAuditRuleTemplatesRequest(AbstractModel):
         :type RuleTemplateIds: list of str
         :param _RuleTemplateNames: 规则模板名称。
         :type RuleTemplateNames: list of str
-        :param _Limit: 单次请求返回的数量。默认值20。
+        :param _Limit: 单次请求返回的数量。默认值20，最大值为1000。
         :type Limit: int
         :param _Offset: 偏移量，默认值为 0。
         :type Offset: int
@@ -13262,7 +13270,7 @@ class DescribeAuditRuleTemplatesRequest(AbstractModel):
 
     @property
     def Limit(self):
-        """单次请求返回的数量。默认值20。
+        """单次请求返回的数量。默认值20，最大值为1000。
         :rtype: int
         """
         return self._Limit
@@ -15014,14 +15022,14 @@ class DescribeCPUExpandStrategyInfoRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例 ID。
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
         """
         self._InstanceId = None
 
     @property
     def InstanceId(self):
-        """实例 ID。
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -15050,18 +15058,19 @@ class DescribeCPUExpandStrategyInfoResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Type: 策略类型。输出值 auto、manual。如果返回为 NULL 说明尚未开通弹性扩容策略。
+        :param _Type: 策略类型。输出值：auto、manual、timeInterval、period。
+说明：1. auto 表示自动扩容。2. manual 表示自定义扩容，扩容时间为立即生效。3. timeInterval 表示自定义扩容，扩容时间为按时间段。4. period 表示自定义扩容，扩容时间为按周期。5. 如果返回为 NULL 说明尚未开通弹性扩容策略。
 注意：此字段可能返回 null，表示取不到有效值。
         :type Type: str
-        :param _ExpandCpu: 手动扩容的 CPU 。Type 为 manual 时有效。
+        :param _ExpandCpu: 自定义扩容，且扩容时间为立即生效时的 CPU。Type 为 manual 时有效。
 注意：此字段可能返回 null，表示取不到有效值。
         :type ExpandCpu: int
         :param _AutoStrategy: 自动扩容策略。Type 为 auto 时有效。
 注意：此字段可能返回 null，表示取不到有效值。
         :type AutoStrategy: :class:`tencentcloud.cdb.v20170320.models.AutoStrategy`
-        :param _PeriodStrategy: 按周期扩容策略。
+        :param _PeriodStrategy: 按周期扩容策略。当 Type 为 period 时有效。
         :type PeriodStrategy: :class:`tencentcloud.cdb.v20170320.models.PeriodStrategy`
-        :param _TimeIntervalStrategy: 按时间段扩容策略。
+        :param _TimeIntervalStrategy: 按时间段扩容策略。当 Type 为 timeInterval 时有效。
         :type TimeIntervalStrategy: :class:`tencentcloud.cdb.v20170320.models.TimeIntervalStrategy`
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -15075,7 +15084,8 @@ class DescribeCPUExpandStrategyInfoResponse(AbstractModel):
 
     @property
     def Type(self):
-        """策略类型。输出值 auto、manual。如果返回为 NULL 说明尚未开通弹性扩容策略。
+        """策略类型。输出值：auto、manual、timeInterval、period。
+说明：1. auto 表示自动扩容。2. manual 表示自定义扩容，扩容时间为立即生效。3. timeInterval 表示自定义扩容，扩容时间为按时间段。4. period 表示自定义扩容，扩容时间为按周期。5. 如果返回为 NULL 说明尚未开通弹性扩容策略。
 注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
         """
@@ -15087,7 +15097,7 @@ class DescribeCPUExpandStrategyInfoResponse(AbstractModel):
 
     @property
     def ExpandCpu(self):
-        """手动扩容的 CPU 。Type 为 manual 时有效。
+        """自定义扩容，且扩容时间为立即生效时的 CPU。Type 为 manual 时有效。
 注意：此字段可能返回 null，表示取不到有效值。
         :rtype: int
         """
@@ -15111,7 +15121,7 @@ class DescribeCPUExpandStrategyInfoResponse(AbstractModel):
 
     @property
     def PeriodStrategy(self):
-        """按周期扩容策略。
+        """按周期扩容策略。当 Type 为 period 时有效。
         :rtype: :class:`tencentcloud.cdb.v20170320.models.PeriodStrategy`
         """
         return self._PeriodStrategy
@@ -15122,7 +15132,7 @@ class DescribeCPUExpandStrategyInfoResponse(AbstractModel):
 
     @property
     def TimeIntervalStrategy(self):
-        """按时间段扩容策略。
+        """按时间段扩容策略。当 Type 为 timeInterval 时有效。
         :rtype: :class:`tencentcloud.cdb.v20170320.models.TimeIntervalStrategy`
         """
         return self._TimeIntervalStrategy
@@ -15459,14 +15469,16 @@ class DescribeClusterInfoRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例 ID。
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
+说明：仅能输入实例架构为云盘版的实例 ID，对应控制台实例配置显示为“云盘版（云盘）”的实例。
         :type InstanceId: str
         """
         self._InstanceId = None
 
     @property
     def InstanceId(self):
-        """实例 ID。
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
+说明：仅能输入实例架构为云盘版的实例 ID，对应控制台实例配置显示为“云盘版（云盘）”的实例。
         :rtype: str
         """
         return self._InstanceId
@@ -19507,9 +19519,10 @@ class DescribeInstanceUpgradeCheckJobRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例ID
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
-        :param _DstMysqlVersion: 目标数据库版本
+        :param _DstMysqlVersion: 目标数据库版本。
+说明：可选值5.6、5.7、8.0，不支持跨版本升级，升级后不支持版本降级。
         :type DstMysqlVersion: str
         """
         self._InstanceId = None
@@ -19517,7 +19530,7 @@ class DescribeInstanceUpgradeCheckJobRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """实例ID
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -19528,7 +19541,8 @@ class DescribeInstanceUpgradeCheckJobRequest(AbstractModel):
 
     @property
     def DstMysqlVersion(self):
-        """目标数据库版本
+        """目标数据库版本。
+说明：可选值5.6、5.7、8.0，不支持跨版本升级，升级后不支持版本降级。
         :rtype: str
         """
         return self._DstMysqlVersion
@@ -20325,14 +20339,14 @@ class DescribeProjectSecurityGroupsRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _ProjectId: 项目ID。
+        :param _ProjectId: 项目 ID。可通过 [DescribeProjects](https://cloud.tencent.com/document/api/651/78725) 接口获取。
         :type ProjectId: int
         """
         self._ProjectId = None
 
     @property
     def ProjectId(self):
-        """项目ID。
+        """项目 ID。可通过 [DescribeProjects](https://cloud.tencent.com/document/api/651/78725) 接口获取。
         :rtype: int
         """
         return self._ProjectId
@@ -20567,14 +20581,14 @@ class DescribeProxySupportParamRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例ID
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
         """
         self._InstanceId = None
 
     @property
     def InstanceId(self):
-        """实例ID
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -26635,11 +26649,11 @@ class ModifyAccountHostRequest(AbstractModel):
         r"""
         :param _InstanceId: 实例 ID，格式如：cdb-c1nl9rpv，与云数据库控制台页面中显示的实例 ID 相同。
         :type InstanceId: str
-        :param _User: 账户的名称
+        :param _User: 账户的名称。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。
         :type User: str
-        :param _Host: 账户的旧主机
+        :param _Host: 账户的旧主机。格式：IP 形式，支持单个 IP 地址或者%。
         :type Host: str
-        :param _NewHost: 账户的新主机
+        :param _NewHost: 账户的新主机。格式：IP 形式，支持单个 IP 地址或者%。
         :type NewHost: str
         """
         self._InstanceId = None
@@ -26660,7 +26674,7 @@ class ModifyAccountHostRequest(AbstractModel):
 
     @property
     def User(self):
-        """账户的名称
+        """账户的名称。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。
         :rtype: str
         """
         return self._User
@@ -26671,7 +26685,7 @@ class ModifyAccountHostRequest(AbstractModel):
 
     @property
     def Host(self):
-        """账户的旧主机
+        """账户的旧主机。格式：IP 形式，支持单个 IP 地址或者%。
         :rtype: str
         """
         return self._Host
@@ -26682,7 +26696,7 @@ class ModifyAccountHostRequest(AbstractModel):
 
     @property
     def NewHost(self):
-        """账户的新主机
+        """账户的新主机。格式：IP 形式，支持单个 IP 地址或者%。
         :rtype: str
         """
         return self._NewHost
@@ -27182,7 +27196,7 @@ class ModifyAuditConfigRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例 ID。
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
         :param _LogExpireDay: 审计日志保存时长。支持值包括：
 7 - 一周
@@ -27193,8 +27207,10 @@ class ModifyAuditConfigRequest(AbstractModel):
 1825 - 五年；
         :type LogExpireDay: int
         :param _CloseAudit: 是否关闭审计服务。可选值：true - 关闭审计服务；false - 不关闭审计服务。默认值为 false。
-当关闭审计服务时，会删除用户的审计日志和文件，并删除该实例的所有审计策略。
-CloseAudit、LogExpireDay必须至少提供一个，如果两个都提供则按照CloseAudit优先的逻辑处理。
+说明：
+1. 当关闭审计服务时，会删除用户的审计日志和文件，并删除该实例的所有审计策略。
+2. CloseAudit、LogExpireDay 必须至少提供一个，如果两个都提供则按照 CloseAudit 优先的逻辑处理。
+3. 可通过设置此参数来关闭审计服务，已关闭后不能通过此接口来开启审计服务。
         :type CloseAudit: bool
         :param _HighLogExpireDay: 高频审计日志保存时长。支持值包括：
 7 - 一周
@@ -27212,7 +27228,7 @@ CloseAudit、LogExpireDay必须至少提供一个，如果两个都提供则按
 
     @property
     def InstanceId(self):
-        """实例 ID。
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -27241,8 +27257,10 @@ CloseAudit、LogExpireDay必须至少提供一个，如果两个都提供则按
     @property
     def CloseAudit(self):
         """是否关闭审计服务。可选值：true - 关闭审计服务；false - 不关闭审计服务。默认值为 false。
-当关闭审计服务时，会删除用户的审计日志和文件，并删除该实例的所有审计策略。
-CloseAudit、LogExpireDay必须至少提供一个，如果两个都提供则按照CloseAudit优先的逻辑处理。
+说明：
+1. 当关闭审计服务时，会删除用户的审计日志和文件，并删除该实例的所有审计策略。
+2. CloseAudit、LogExpireDay 必须至少提供一个，如果两个都提供则按照 CloseAudit 优先的逻辑处理。
+3. 可通过设置此参数来关闭审计服务，已关闭后不能通过此接口来开启审计服务。
         :rtype: bool
         """
         return self._CloseAudit
@@ -27448,7 +27466,7 @@ class ModifyAuditRuleTemplatesRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _RuleTemplateIds: 审计规则模板ID。
+        :param _RuleTemplateIds: 审计规则模板 ID。可通过 [DescribeAuditRuleTemplates](https://cloud.tencent.com/document/api/236/101811) 接口获取。
         :type RuleTemplateIds: list of str
         :param _RuleFilters: 修改后的审计规则。
         :type RuleFilters: list of RuleFilters
@@ -27470,7 +27488,7 @@ class ModifyAuditRuleTemplatesRequest(AbstractModel):
 
     @property
     def RuleTemplateIds(self):
-        """审计规则模板ID。
+        """审计规则模板 ID。可通过 [DescribeAuditRuleTemplates](https://cloud.tencent.com/document/api/236/101811) 接口获取。
         :rtype: list of str
         """
         return self._RuleTemplateIds
@@ -27592,17 +27610,32 @@ class ModifyAuditServiceRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例ID。
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
-        :param _LogExpireDay: 日志保留时长。
+        :param _LogExpireDay: 日志保留时长。支持值包括：
+7 - 一周；
+30 - 一个月；
+90 - 三个月；
+180 - 六个月；
+365 - 一年；
+1095 - 三年；
+1825 - 五年。
         :type LogExpireDay: int
-        :param _HighLogExpireDay: 高频日志保留时长。
+        :param _HighLogExpireDay: 高频日志保留时长。默认值为7，此项取值需小于等于 LogExpireDay，支持值包括：
+3 - 3天；
+7 - 一周；
+30 - 一个月；
+90 - 三个月；
+180 - 六个月；
+365 - 一年；
+1095 - 三年；
+1825 - 五年。
         :type HighLogExpireDay: int
         :param _AuditAll: 修改实例审计规则为全审计。
         :type AuditAll: bool
         :param _AuditRuleFilters: 废弃。
         :type AuditRuleFilters: list of AuditRuleFilters
-        :param _RuleTemplateIds: 规则模板ID。
+        :param _RuleTemplateIds: 规则模板 ID。可通过 [DescribeAuditRuleTemplates](https://cloud.tencent.com/document/api/236/101811) 接口获取。
         :type RuleTemplateIds: list of str
         """
         self._InstanceId = None
@@ -27614,7 +27647,7 @@ class ModifyAuditServiceRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """实例ID。
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -27625,7 +27658,14 @@ class ModifyAuditServiceRequest(AbstractModel):
 
     @property
     def LogExpireDay(self):
-        """日志保留时长。
+        """日志保留时长。支持值包括：
+7 - 一周；
+30 - 一个月；
+90 - 三个月；
+180 - 六个月；
+365 - 一年；
+1095 - 三年；
+1825 - 五年。
         :rtype: int
         """
         return self._LogExpireDay
@@ -27636,7 +27676,15 @@ class ModifyAuditServiceRequest(AbstractModel):
 
     @property
     def HighLogExpireDay(self):
-        """高频日志保留时长。
+        """高频日志保留时长。默认值为7，此项取值需小于等于 LogExpireDay，支持值包括：
+3 - 3天；
+7 - 一周；
+30 - 一个月；
+90 - 三个月；
+180 - 六个月；
+365 - 一年；
+1095 - 三年；
+1825 - 五年。
         :rtype: int
         """
         return self._HighLogExpireDay
@@ -27673,7 +27721,7 @@ class ModifyAuditServiceRequest(AbstractModel):
 
     @property
     def RuleTemplateIds(self):
-        """规则模板ID。
+        """规则模板 ID。可通过 [DescribeAuditRuleTemplates](https://cloud.tencent.com/document/api/236/101811) 接口获取。
         :rtype: list of str
         """
         return self._RuleTemplateIds
@@ -28388,9 +28436,9 @@ class ModifyCdbProxyAddressDescRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _ProxyGroupId: 代理组ID
+        :param _ProxyGroupId: 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyGroupId: str
-        :param _ProxyAddressId: 代理组地址ID
+        :param _ProxyAddressId: 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyAddressId: str
         :param _Desc: 描述
         :type Desc: str
@@ -28401,7 +28449,7 @@ class ModifyCdbProxyAddressDescRequest(AbstractModel):
 
     @property
     def ProxyGroupId(self):
-        """代理组ID
+        """代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyGroupId
@@ -28412,7 +28460,7 @@ class ModifyCdbProxyAddressDescRequest(AbstractModel):
 
     @property
     def ProxyAddressId(self):
-        """代理组地址ID
+        """代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyAddressId
@@ -28482,19 +28530,19 @@ class ModifyCdbProxyAddressVipAndVPortRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _ProxyGroupId: 代理组ID
+        :param _ProxyGroupId: 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyGroupId: str
-        :param _ProxyAddressId: 代理组地址ID
+        :param _ProxyAddressId: 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyAddressId: str
-        :param _UniqVpcId: 私有网络ID
+        :param _UniqVpcId: 私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type UniqVpcId: str
-        :param _UniqSubnetId: 私有子网ID
+        :param _UniqSubnetId: 私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type UniqSubnetId: str
-        :param _Vip: IP地址
+        :param _Vip: IP 地址。若不填写则自动分配子网下的可用 IP。
         :type Vip: str
-        :param _VPort: 端口
+        :param _VPort: 端口。默认值3306，取值范围：1024 - 65535。
         :type VPort: int
-        :param _ReleaseDuration: 旧IP地址回收时间
+        :param _ReleaseDuration: 旧 IP 地址回收时间。单位：小时，默认值：24，取值范围：0 - 168。
         :type ReleaseDuration: int
         """
         self._ProxyGroupId = None
@@ -28507,7 +28555,7 @@ class ModifyCdbProxyAddressVipAndVPortRequest(AbstractModel):
 
     @property
     def ProxyGroupId(self):
-        """代理组ID
+        """代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyGroupId
@@ -28518,7 +28566,7 @@ class ModifyCdbProxyAddressVipAndVPortRequest(AbstractModel):
 
     @property
     def ProxyAddressId(self):
-        """代理组地址ID
+        """代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyAddressId
@@ -28529,7 +28577,7 @@ class ModifyCdbProxyAddressVipAndVPortRequest(AbstractModel):
 
     @property
     def UniqVpcId(self):
-        """私有网络ID
+        """私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._UniqVpcId
@@ -28540,7 +28588,7 @@ class ModifyCdbProxyAddressVipAndVPortRequest(AbstractModel):
 
     @property
     def UniqSubnetId(self):
-        """私有子网ID
+        """私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._UniqSubnetId
@@ -28551,7 +28599,7 @@ class ModifyCdbProxyAddressVipAndVPortRequest(AbstractModel):
 
     @property
     def Vip(self):
-        """IP地址
+        """IP 地址。若不填写则自动分配子网下的可用 IP。
         :rtype: str
         """
         return self._Vip
@@ -28562,7 +28610,7 @@ class ModifyCdbProxyAddressVipAndVPortRequest(AbstractModel):
 
     @property
     def VPort(self):
-        """端口
+        """端口。默认值3306，取值范围：1024 - 65535。
         :rtype: int
         """
         return self._VPort
@@ -28573,7 +28621,7 @@ class ModifyCdbProxyAddressVipAndVPortRequest(AbstractModel):
 
     @property
     def ReleaseDuration(self):
-        """旧IP地址回收时间
+        """旧 IP 地址回收时间。单位：小时，默认值：24，取值范围：0 - 168。
         :rtype: int
         """
         return self._ReleaseDuration
@@ -28636,11 +28684,11 @@ class ModifyCdbProxyParamRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例ID
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
-        :param _ProxyGroupId: 代理组ID
+        :param _ProxyGroupId: 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyGroupId: str
-        :param _ConnectionPoolLimit: 连接池阈值
+        :param _ConnectionPoolLimit: 连接池阈值。取值范围：大于0，小于等于300。
 注意：如需使用数据库代理连接池能力，MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。
         :type ConnectionPoolLimit: int
         """
@@ -28650,7 +28698,7 @@ class ModifyCdbProxyParamRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """实例ID
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -28661,7 +28709,7 @@ class ModifyCdbProxyParamRequest(AbstractModel):
 
     @property
     def ProxyGroupId(self):
-        """代理组ID
+        """代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyGroupId
@@ -28672,7 +28720,7 @@ class ModifyCdbProxyParamRequest(AbstractModel):
 
     @property
     def ConnectionPoolLimit(self):
-        """连接池阈值
+        """连接池阈值。取值范围：大于0，小于等于300。
 注意：如需使用数据库代理连接池能力，MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。
         :rtype: int
         """
@@ -30768,26 +30816,32 @@ class OpenAuditServiceRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: CDB实例ID
+        :param _InstanceId: CDB 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
         :param _LogExpireDay: 审计日志保存时长。支持值包括：
-7 - 一周
+7 - 一周；
 30 - 一个月；
 90 - 三个月；
 180 - 六个月；
 365 - 一年；
 1095 - 三年；
-1825 - 五年；
+1825 - 五年。
         :type LogExpireDay: int
-        :param _HighLogExpireDay: 高频审计日志保存时长。支持值包括：
-7 - 一周
+        :param _HighLogExpireDay: 高频审计日志保存时长。默认值为7，此项取值需小于等于 LogExpireDay，支持值包括：
+3 - 3天；
+7 - 一周；
 30 - 一个月；
+90 - 三个月；
+180 - 六个月；
+365 - 一年；
+1095 - 三年；
+1825 - 五年。
         :type HighLogExpireDay: int
         :param _AuditRuleFilters: 审计规则（该参数已废弃，不再生效）。
         :type AuditRuleFilters: list of AuditRuleFilters
-        :param _RuleTemplateIds: 规则模板ID。同AuditRuleFilters都不填是全审计。
+        :param _RuleTemplateIds: 规则模板 ID。
         :type RuleTemplateIds: list of str
-        :param _AuditAll: 审计类型。true-全审计；默认false-规则审计。
+        :param _AuditAll: 审计类型。true - 全审计；默认 false - 规则审计。
         :type AuditAll: bool
         """
         self._InstanceId = None
@@ -30799,7 +30853,7 @@ class OpenAuditServiceRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """CDB实例ID
+        """CDB 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -30811,13 +30865,13 @@ class OpenAuditServiceRequest(AbstractModel):
     @property
     def LogExpireDay(self):
         """审计日志保存时长。支持值包括：
-7 - 一周
+7 - 一周；
 30 - 一个月；
 90 - 三个月；
 180 - 六个月；
 365 - 一年；
 1095 - 三年；
-1825 - 五年；
+1825 - 五年。
         :rtype: int
         """
         return self._LogExpireDay
@@ -30828,9 +30882,15 @@ class OpenAuditServiceRequest(AbstractModel):
 
     @property
     def HighLogExpireDay(self):
-        """高频审计日志保存时长。支持值包括：
-7 - 一周
+        """高频审计日志保存时长。默认值为7，此项取值需小于等于 LogExpireDay，支持值包括：
+3 - 3天；
+7 - 一周；
 30 - 一个月；
+90 - 三个月；
+180 - 六个月；
+365 - 一年；
+1095 - 三年；
+1825 - 五年。
         :rtype: int
         """
         return self._HighLogExpireDay
@@ -30856,7 +30916,7 @@ class OpenAuditServiceRequest(AbstractModel):
 
     @property
     def RuleTemplateIds(self):
-        """规则模板ID。同AuditRuleFilters都不填是全审计。
+        """规则模板 ID。
         :rtype: list of str
         """
         return self._RuleTemplateIds
@@ -30867,7 +30927,7 @@ class OpenAuditServiceRequest(AbstractModel):
 
     @property
     def AuditAll(self):
-        """审计类型。true-全审计；默认false-规则审计。
+        """审计类型。true - 全审计；默认 false - 规则审计。
         :rtype: bool
         """
         return self._AuditAll
@@ -30934,7 +30994,7 @@ class OpenDBInstanceEncryptionRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 云数据库实例 ID。
+        :param _InstanceId: 云数据库实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
         :param _KeyId: 用户自定义密钥 ID，CMK 唯一标识符。该值为空时，将使用腾讯云自动生成的密钥 KMS-CDB。
         :type KeyId: str
@@ -30947,7 +31007,7 @@ class OpenDBInstanceEncryptionRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """云数据库实例 ID。
+        """云数据库实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -31107,9 +31167,9 @@ class OpenSSLRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例 ID 。
+        :param _InstanceId: 实例 ID。只读组 ID 为空时必填。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
-        :param _RoGroupId: 只读组 ID。
+        :param _RoGroupId: 只读组 ID。实例 ID 为空时必填。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。
         :type RoGroupId: str
         """
         self._InstanceId = None
@@ -31117,7 +31177,7 @@ class OpenSSLRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """实例 ID 。
+        """实例 ID。只读组 ID 为空时必填。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -31128,7 +31188,7 @@ class OpenSSLRequest(AbstractModel):
 
     @property
     def RoGroupId(self):
-        """只读组 ID。
+        """只读组 ID。实例 ID 为空时必填。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。
         :rtype: str
         """
         return self._RoGroupId
@@ -31201,7 +31261,7 @@ class OpenWanServiceRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例 ID，格式如：cdb-c1nl9rpv，与云数据库控制台页面中显示的实例 ID 相同，可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取，其值为输出参数中字段 InstanceId 的值。
+        :param _InstanceId: 实例 ID，格式如：cdb-c1nl9rpv，与云数据库控制台页面中显示的实例 ID 相同，可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取，其值为输出参数中字段 InstanceId 的值。可以传入只读组 ID。
         :type InstanceId: str
         :param _OpResourceId: 变更集群版实例只读组时，InstanceId传实例id，需要额外指定该参数表示操作只读组。 如果操作读写节点则不需指定该参数。
         :type OpResourceId: str
@@ -31211,7 +31271,7 @@ class OpenWanServiceRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """实例 ID，格式如：cdb-c1nl9rpv，与云数据库控制台页面中显示的实例 ID 相同，可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取，其值为输出参数中字段 InstanceId 的值。
+        """实例 ID，格式如：cdb-c1nl9rpv，与云数据库控制台页面中显示的实例 ID 相同，可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取，其值为输出参数中字段 InstanceId 的值。可以传入只读组 ID。
         :rtype: str
         """
         return self._InstanceId
@@ -34046,15 +34106,17 @@ class RoGroupAttr(AbstractModel):
         r"""
         :param _RoGroupName: RO 组名称。
         :type RoGroupName: str
-        :param _RoMaxDelayTime: RO 实例最大延迟阈值。单位为秒，最小值为 1。注意，RO 组必须设置了开启实例延迟剔除策略，该值才有效。
+        :param _RoMaxDelayTime: RO 实例最大延迟阈值。单位为秒，最小值为 1。范围：[1,10000]，整数。
+注意：RO 组必须设置了开启实例延迟剔除策略，该值才有效。
         :type RoMaxDelayTime: int
         :param _RoOfflineDelay: 是否开启实例延迟剔除。支持的值包括：1 - 开启；0 - 不开启。注意，若设置开启实例延迟剔除，则必须设置延迟阈值（RoMaxDelayTime）参数。
         :type RoOfflineDelay: int
-        :param _MinRoInGroup: 最少保留实例数。可设置为小于或等于该 RO 组下 RO 实例个数的任意值。注意，若设置值大于 RO 实例数量将不做剔除；若设置为 0，所有实例延迟超限都会被剔除。
+        :param _MinRoInGroup: 最少保留实例数。可设置为小于或等于该 RO 组下 RO 实例个数的任意值。默认值为1。
+注意：若设置值大于 RO 实例数量将不做剔除；若设置为 0，所有实例延迟超限都会被剔除。
         :type MinRoInGroup: int
         :param _WeightMode: 权重模式。支持值包括："system" - 系统自动分配； "custom" - 用户自定义设置。注意，若设置 "custom" 模式，则必须设置 RO 实例权重配置（RoWeightValues）参数。
         :type WeightMode: str
-        :param _ReplicationDelayTime: 延迟复制时间。
+        :param _ReplicationDelayTime: 延迟复制时间。单位：秒，范围：1 - 259200秒，不传此参数表示不开启实例延迟复制。
         :type ReplicationDelayTime: int
         """
         self._RoGroupName = None
@@ -34077,7 +34139,8 @@ class RoGroupAttr(AbstractModel):
 
     @property
     def RoMaxDelayTime(self):
-        """RO 实例最大延迟阈值。单位为秒，最小值为 1。注意，RO 组必须设置了开启实例延迟剔除策略，该值才有效。
+        """RO 实例最大延迟阈值。单位为秒，最小值为 1。范围：[1,10000]，整数。
+注意：RO 组必须设置了开启实例延迟剔除策略，该值才有效。
         :rtype: int
         """
         return self._RoMaxDelayTime
@@ -34099,7 +34162,8 @@ class RoGroupAttr(AbstractModel):
 
     @property
     def MinRoInGroup(self):
-        """最少保留实例数。可设置为小于或等于该 RO 组下 RO 实例个数的任意值。注意，若设置值大于 RO 实例数量将不做剔除；若设置为 0，所有实例延迟超限都会被剔除。
+        """最少保留实例数。可设置为小于或等于该 RO 组下 RO 实例个数的任意值。默认值为1。
+注意：若设置值大于 RO 实例数量将不做剔除；若设置为 0，所有实例延迟超限都会被剔除。
         :rtype: int
         """
         return self._MinRoInGroup
@@ -34121,7 +34185,7 @@ class RoGroupAttr(AbstractModel):
 
     @property
     def ReplicationDelayTime(self):
-        """延迟复制时间。
+        """延迟复制时间。单位：秒，范围：1 - 259200秒，不传此参数表示不开启实例延迟复制。
         :rtype: int
         """
         return self._ReplicationDelayTime
@@ -36279,7 +36343,7 @@ class StartCpuExpandRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例 ID。
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
         :param _Type: 扩容类型，支持自动扩容和自定义扩容。
 说明：1. auto 表示自动扩容。2. manual 表示自定义扩容，扩容时间为立即生效。3. timeInterval 表示自定义扩容，扩容时间为按时间段。4. period 表示自定义扩容，扩容时间为按周期。
@@ -36290,8 +36354,10 @@ class StartCpuExpandRequest(AbstractModel):
         :param _AutoStrategy: 自动扩容策略。Type 为 auto 时必传。
         :type AutoStrategy: :class:`tencentcloud.cdb.v20170320.models.AutoStrategy`
         :param _TimeIntervalStrategy: 按时间段扩容策略。
+说明：当 Type 为 timeInterval 时，TimeIntervalStrategy 必填。
         :type TimeIntervalStrategy: :class:`tencentcloud.cdb.v20170320.models.TimeIntervalStrategy`
         :param _PeriodStrategy: 按周期扩容策略。
+说明：当 Type 为 period 时，PeriodStrategy 必填。
         :type PeriodStrategy: :class:`tencentcloud.cdb.v20170320.models.PeriodStrategy`
         """
         self._InstanceId = None
@@ -36303,7 +36369,7 @@ class StartCpuExpandRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """实例 ID。
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -36350,6 +36416,7 @@ class StartCpuExpandRequest(AbstractModel):
     @property
     def TimeIntervalStrategy(self):
         """按时间段扩容策略。
+说明：当 Type 为 timeInterval 时，TimeIntervalStrategy 必填。
         :rtype: :class:`tencentcloud.cdb.v20170320.models.TimeIntervalStrategy`
         """
         return self._TimeIntervalStrategy
@@ -36361,6 +36428,7 @@ class StartCpuExpandRequest(AbstractModel):
     @property
     def PeriodStrategy(self):
         """按周期扩容策略。
+说明：当 Type 为 period 时，PeriodStrategy 必填。
         :rtype: :class:`tencentcloud.cdb.v20170320.models.PeriodStrategy`
         """
         return self._PeriodStrategy
@@ -36400,7 +36468,7 @@ class StartCpuExpandResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _AsyncRequestId: 异步任务 ID 。可以调用DescribeAsyncRequest 传入该 ID ，进行任务执行进度的查询
+        :param _AsyncRequestId: 异步任务 ID 。可以调用 DescribeAsyncRequest 传入该 ID，进行任务执行进度的查询。
         :type AsyncRequestId: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -36410,7 +36478,7 @@ class StartCpuExpandResponse(AbstractModel):
 
     @property
     def AsyncRequestId(self):
-        """异步任务 ID 。可以调用DescribeAsyncRequest 传入该 ID ，进行任务执行进度的查询
+        """异步任务 ID 。可以调用 DescribeAsyncRequest 传入该 ID，进行任务执行进度的查询。
         :rtype: str
         """
         return self._AsyncRequestId
@@ -36823,9 +36891,10 @@ class SubmitInstanceUpgradeCheckJobRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例 ID。
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
         :param _DstMysqlVersion: 目标数据库版本。
+说明：可选值5.6、5.7、8.0，不支持跨版本升级，升级后不支持版本降级。
         :type DstMysqlVersion: str
         """
         self._InstanceId = None
@@ -36833,7 +36902,7 @@ class SubmitInstanceUpgradeCheckJobRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """实例 ID。
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -36845,6 +36914,7 @@ class SubmitInstanceUpgradeCheckJobRequest(AbstractModel):
     @property
     def DstMysqlVersion(self):
         """目标数据库版本。
+说明：可选值5.6、5.7、8.0，不支持跨版本升级，升级后不支持版本降级。
         :rtype: str
         """
         return self._DstMysqlVersion
@@ -36917,9 +36987,9 @@ class SwitchCDBProxyRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例ID
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
-        :param _ProxyGroupId: 数据库代理ID
+        :param _ProxyGroupId: 数据库代理 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyGroupId: str
         """
         self._InstanceId = None
@@ -36927,7 +36997,7 @@ class SwitchCDBProxyRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """实例ID
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -36938,7 +37008,7 @@ class SwitchCDBProxyRequest(AbstractModel):
 
     @property
     def ProxyGroupId(self):
-        """数据库代理ID
+        """数据库代理 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyGroupId
@@ -38138,9 +38208,9 @@ class UpgradeCDBProxyVersionRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceId: 实例ID
+        :param _InstanceId: 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :type InstanceId: str
-        :param _ProxyGroupId: 数据库代理ID
+        :param _ProxyGroupId: 数据库代理 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :type ProxyGroupId: str
         :param _SrcProxyVersion: 数据库代理当前版本
         :type SrcProxyVersion: str
@@ -38157,7 +38227,7 @@ class UpgradeCDBProxyVersionRequest(AbstractModel):
 
     @property
     def InstanceId(self):
-        """实例ID
+        """实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。
         :rtype: str
         """
         return self._InstanceId
@@ -38168,7 +38238,7 @@ class UpgradeCDBProxyVersionRequest(AbstractModel):
 
     @property
     def ProxyGroupId(self):
-        """数据库代理ID
+        """数据库代理 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。
         :rtype: str
         """
         return self._ProxyGroupId
@@ -38464,11 +38534,12 @@ class UpgradeDBInstanceRequest(AbstractModel):
         :type DeployMode: int
         :param _SlaveZone: 备库1的可用区信息，默认和实例的 Zone 参数一致，升级主实例为多可用区部署时可指定该参数，升级只读实例或者灾备实例时指定该参数无意义。可通过 [获取云数据库可售卖规格](https://cloud.tencent.com/document/product/236/17229) 接口查询支持的可用区。
         :type SlaveZone: str
-        :param _EngineVersion: 主实例数据库引擎版本，支持值包括：5.5、5.6 和 5.7。
+        :param _EngineVersion: 主实例数据库引擎版本，支持值包括：5.5、5.6、5.7、8.0。
+说明：升级数据库版本请使用 [UpgradeDBInstanceEngineVersion](https://cloud.tencent.com/document/api/236/15870) 接口。
         :type EngineVersion: str
         :param _WaitSwitch: 切换访问新实例的方式，默认为 0。支持值包括：0 - 立刻切换，1 - 时间窗切换；当该值为 1 时，升级过程中，切换访问新实例的流程将会在时间窗内进行，或者用户主动调用接口 [切换访问新实例](https://cloud.tencent.com/document/product/236/15864) 触发该流程。
         :type WaitSwitch: int
-        :param _BackupZone: 备库 2 的可用区信息，默认为空，升级主实例时可指定该参数，升级只读实例或者灾备实例时指定该参数无意义。
+        :param _BackupZone: 备库2的可用区信息，默认为空，升级主实例时可指定该参数，升级只读实例或者灾备实例时指定该参数无意义。可通过 [获取云数据库可售卖规格](https://cloud.tencent.com/document/product/236/17229) 接口查询支持的可用区。
 备注：如您要将三节点降级至双节点，将该参数设置为空值即可实现。
         :type BackupZone: str
         :param _InstanceRole: 实例类型，默认为 master，支持值包括：master - 表示主实例，dr - 表示灾备实例，ro - 表示只读实例。
@@ -38591,7 +38662,8 @@ class UpgradeDBInstanceRequest(AbstractModel):
 
     @property
     def EngineVersion(self):
-        """主实例数据库引擎版本，支持值包括：5.5、5.6 和 5.7。
+        """主实例数据库引擎版本，支持值包括：5.5、5.6、5.7、8.0。
+说明：升级数据库版本请使用 [UpgradeDBInstanceEngineVersion](https://cloud.tencent.com/document/api/236/15870) 接口。
         :rtype: str
         """
         return self._EngineVersion
@@ -38613,7 +38685,7 @@ class UpgradeDBInstanceRequest(AbstractModel):
 
     @property
     def BackupZone(self):
-        """备库 2 的可用区信息，默认为空，升级主实例时可指定该参数，升级只读实例或者灾备实例时指定该参数无意义。
+        """备库2的可用区信息，默认为空，升级主实例时可指定该参数，升级只读实例或者灾备实例时指定该参数无意义。可通过 [获取云数据库可售卖规格](https://cloud.tencent.com/document/product/236/17229) 接口查询支持的可用区。
 备注：如您要将三节点降级至双节点，将该参数设置为空值即可实现。
         :rtype: str
         """
@@ -38794,7 +38866,7 @@ class UpgradeDBInstanceResponse(AbstractModel):
         r"""
         :param _DealIds: 订单 ID。
         :type DealIds: list of str
-        :param _AsyncRequestId: 异步任务的请求 ID，可使用此 ID 查询异步任务的执行结果。
+        :param _AsyncRequestId: 异步任务的请求 ID，可使用此 ID [查询异步任务的执行结果](https://cloud.tencent.com/document/product/236/20410)。
         :type AsyncRequestId: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -38816,7 +38888,7 @@ class UpgradeDBInstanceResponse(AbstractModel):
 
     @property
     def AsyncRequestId(self):
-        """异步任务的请求 ID，可使用此 ID 查询异步任务的执行结果。
+        """异步任务的请求 ID，可使用此 ID [查询异步任务的执行结果](https://cloud.tencent.com/document/product/236/20410)。
         :rtype: str
         """
         return self._AsyncRequestId