tencentcloud-sdk-python 3.0.1249__py2.py3-none-any.whl → 3.0.1251__py2.py3-none-any.whl

tencentcloud/dlc/v20210125/models.py

@@ -721,6 +721,218 @@ class AlterDMSTableResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class AnalysisTaskResults(AbstractModel):
+    """洞察分析结果返回体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Id: 任务Id
+        :type Id: str
+        :param _InstanceStartTime: 任务创建时间，毫秒时间戳
+        :type InstanceStartTime: int
+        :param _InstanceCompleteTime: 任务结束时间，毫秒时间戳
+注意：此字段可能返回 null，表示取不到有效值。
+        :type InstanceCompleteTime: int
+        :param _State: 任务状态：0 初始化， 1 执行中， 2 执行成功，3 数据写入中，4 排队中。-1 执行失败，-3 已取消。
+        :type State: int
+        :param _SQL: 任务SQL语句
+        :type SQL: str
+        :param _DataEngineName: 计算资源名字
+注意：此字段可能返回 null，表示取不到有效值。
+        :type DataEngineName: str
+        :param _JobTimeSum: 单位毫秒，引擎内执行耗时
+注意：此字段可能返回 null，表示取不到有效值。
+        :type JobTimeSum: int
+        :param _TaskTimeSum: 单位秒，CU资源消耗
+注意：此字段可能返回 null，表示取不到有效值。
+        :type TaskTimeSum: int
+        :param _InputRecordsSum: 数据扫描总行数
+注意：此字段可能返回 null，表示取不到有效值。
+        :type InputRecordsSum: int
+        :param _InputBytesSum: 数据扫描总 bytes
+注意：此字段可能返回 null，表示取不到有效值。
+        :type InputBytesSum: int
+        :param _OutputRecordsSum: 输出总行数
+注意：此字段可能返回 null，表示取不到有效值。
+        :type OutputRecordsSum: int
+        :param _OutputBytesSum: 输出总 bytes
+注意：此字段可能返回 null，表示取不到有效值。
+        :type OutputBytesSum: int
+        :param _ShuffleReadBytesSum: shuffle read 总 bytes
+注意：此字段可能返回 null，表示取不到有效值。
+        :type ShuffleReadBytesSum: int
+        :param _ShuffleReadRecordsSum: shuffle read 总行数
+注意：此字段可能返回 null，表示取不到有效值。
+        :type ShuffleReadRecordsSum: int
+        :param _AnalysisStatus: 洞察结果类型分类，一个 json 数组，有如下几种类型：SPARK-StageScheduleDelay（资源抢占）, SPARK-ShuffleFailure（Shuffle异常）, SPARK-SlowTask（慢task）, SPARK-DataSkew（数据倾斜）, SPARK-InsufficientResource（磁盘或内存不足）
+注意：此字段可能返回 null，表示取不到有效值。
+        :type AnalysisStatus: str
+        """
+        self._Id = None
+        self._InstanceStartTime = None
+        self._InstanceCompleteTime = None
+        self._State = None
+        self._SQL = None
+        self._DataEngineName = None
+        self._JobTimeSum = None
+        self._TaskTimeSum = None
+        self._InputRecordsSum = None
+        self._InputBytesSum = None
+        self._OutputRecordsSum = None
+        self._OutputBytesSum = None
+        self._ShuffleReadBytesSum = None
+        self._ShuffleReadRecordsSum = None
+        self._AnalysisStatus = None
+
+    @property
+    def Id(self):
+        return self._Id
+
+    @Id.setter
+    def Id(self, Id):
+        self._Id = Id
+
+    @property
+    def InstanceStartTime(self):
+        return self._InstanceStartTime
+
+    @InstanceStartTime.setter
+    def InstanceStartTime(self, InstanceStartTime):
+        self._InstanceStartTime = InstanceStartTime
+
+    @property
+    def InstanceCompleteTime(self):
+        return self._InstanceCompleteTime
+
+    @InstanceCompleteTime.setter
+    def InstanceCompleteTime(self, InstanceCompleteTime):
+        self._InstanceCompleteTime = InstanceCompleteTime
+
+    @property
+    def State(self):
+        return self._State
+
+    @State.setter
+    def State(self, State):
+        self._State = State
+
+    @property
+    def SQL(self):
+        return self._SQL
+
+    @SQL.setter
+    def SQL(self, SQL):
+        self._SQL = SQL
+
+    @property
+    def DataEngineName(self):
+        return self._DataEngineName
+
+    @DataEngineName.setter
+    def DataEngineName(self, DataEngineName):
+        self._DataEngineName = DataEngineName
+
+    @property
+    def JobTimeSum(self):
+        return self._JobTimeSum
+
+    @JobTimeSum.setter
+    def JobTimeSum(self, JobTimeSum):
+        self._JobTimeSum = JobTimeSum
+
+    @property
+    def TaskTimeSum(self):
+        return self._TaskTimeSum
+
+    @TaskTimeSum.setter
+    def TaskTimeSum(self, TaskTimeSum):
+        self._TaskTimeSum = TaskTimeSum
+
+    @property
+    def InputRecordsSum(self):
+        return self._InputRecordsSum
+
+    @InputRecordsSum.setter
+    def InputRecordsSum(self, InputRecordsSum):
+        self._InputRecordsSum = InputRecordsSum
+
+    @property
+    def InputBytesSum(self):
+        return self._InputBytesSum
+
+    @InputBytesSum.setter
+    def InputBytesSum(self, InputBytesSum):
+        self._InputBytesSum = InputBytesSum
+
+    @property
+    def OutputRecordsSum(self):
+        return self._OutputRecordsSum
+
+    @OutputRecordsSum.setter
+    def OutputRecordsSum(self, OutputRecordsSum):
+        self._OutputRecordsSum = OutputRecordsSum
+
+    @property
+    def OutputBytesSum(self):
+        return self._OutputBytesSum
+
+    @OutputBytesSum.setter
+    def OutputBytesSum(self, OutputBytesSum):
+        self._OutputBytesSum = OutputBytesSum
+
+    @property
+    def ShuffleReadBytesSum(self):
+        return self._ShuffleReadBytesSum
+
+    @ShuffleReadBytesSum.setter
+    def ShuffleReadBytesSum(self, ShuffleReadBytesSum):
+        self._ShuffleReadBytesSum = ShuffleReadBytesSum
+
+    @property
+    def ShuffleReadRecordsSum(self):
+        return self._ShuffleReadRecordsSum
+
+    @ShuffleReadRecordsSum.setter
+    def ShuffleReadRecordsSum(self, ShuffleReadRecordsSum):
+        self._ShuffleReadRecordsSum = ShuffleReadRecordsSum
+
+    @property
+    def AnalysisStatus(self):
+        return self._AnalysisStatus
+
+    @AnalysisStatus.setter
+    def AnalysisStatus(self, AnalysisStatus):
+        self._AnalysisStatus = AnalysisStatus
+
+
+    def _deserialize(self, params):
+        self._Id = params.get("Id")
+        self._InstanceStartTime = params.get("InstanceStartTime")
+        self._InstanceCompleteTime = params.get("InstanceCompleteTime")
+        self._State = params.get("State")
+        self._SQL = params.get("SQL")
+        self._DataEngineName = params.get("DataEngineName")
+        self._JobTimeSum = params.get("JobTimeSum")
+        self._TaskTimeSum = params.get("TaskTimeSum")
+        self._InputRecordsSum = params.get("InputRecordsSum")
+        self._InputBytesSum = params.get("InputBytesSum")
+        self._OutputRecordsSum = params.get("OutputRecordsSum")
+        self._OutputBytesSum = params.get("OutputBytesSum")
+        self._ShuffleReadBytesSum = params.get("ShuffleReadBytesSum")
+        self._ShuffleReadRecordsSum = params.get("ShuffleReadRecordsSum")
+        self._AnalysisStatus = params.get("AnalysisStatus")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
 class Asset(AbstractModel):
     """元数据基本对象
 
@@ -15516,6 +15728,182 @@ class DescribeTaskResultResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class DescribeTasksAnalysisRequest(AbstractModel):
+    """DescribeTasksAnalysis请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _DataEngineName: 数据引擎名称，用于筛选
+        :type DataEngineName: str
+        :param _Limit: 返回数量，默认为10，最大值为100。
+        :type Limit: int
+        :param _Offset: 偏移量，默认为0。
+        :type Offset: int
+        :param _Filters: 过滤条件，如下支持的过滤类型，传参Name应为以下其中一个: task-id - String - （任务ID准确过滤）task-id 取值形如：e386471f-139a-4e59-877f-50ece8135b99。task-state - String - （任务状态过滤）取值范围 0(初始化)， 1(运行中)， 2(成功)， -1(失败)，rule-id - String - （洞察类型）取值范围 SPARK-StageScheduleDelay（资源抢占）, SPARK-ShuffleFailure（Shuffle异常）, SPARK-SlowTask（慢task）, SPARK-DataSkew（数据倾斜）, SPARK-InsufficientResource（磁盘或内存不足）
+        :type Filters: list of Filter
+        :param _SortBy: 排序字段，支持如下字段类型，instance-start-time (任务开始时间）, instance-complete-time (任务结束时间）,job-time-sum （单位毫秒，引擎内执行耗时）,task-time-sum （CU资源消耗，单位秒）,input-bytes-sum（数据扫描总大小，单位bytes）,shuffle-read-bytes-sum（数据shuffle总大小，单位bytes）
+        :type SortBy: str
+        :param _Sorting: 排序方式，desc表示正序，asc表示反序， 默认为asc。
+        :type Sorting: str
+        :param _StartTime: 起始时间点，格式为yyyy-mm-dd HH:MM:SS
+        :type StartTime: str
+        :param _EndTime: 结束时间点，格式为yyyy-mm-dd HH:MM:SS时间跨度在(0,30天]，支持最近45天数据查询。默认为当前时刻
+        :type EndTime: str
+        """
+        self._DataEngineName = None
+        self._Limit = None
+        self._Offset = None
+        self._Filters = None
+        self._SortBy = None
+        self._Sorting = None
+        self._StartTime = None
+        self._EndTime = None
+
+    @property
+    def DataEngineName(self):
+        return self._DataEngineName
+
+    @DataEngineName.setter
+    def DataEngineName(self, DataEngineName):
+        self._DataEngineName = DataEngineName
+
+    @property
+    def Limit(self):
+        return self._Limit
+
+    @Limit.setter
+    def Limit(self, Limit):
+        self._Limit = Limit
+
+    @property
+    def Offset(self):
+        return self._Offset
+
+    @Offset.setter
+    def Offset(self, Offset):
+        self._Offset = Offset
+
+    @property
+    def Filters(self):
+        return self._Filters
+
+    @Filters.setter
+    def Filters(self, Filters):
+        self._Filters = Filters
+
+    @property
+    def SortBy(self):
+        return self._SortBy
+
+    @SortBy.setter
+    def SortBy(self, SortBy):
+        self._SortBy = SortBy
+
+    @property
+    def Sorting(self):
+        return self._Sorting
+
+    @Sorting.setter
+    def Sorting(self, Sorting):
+        self._Sorting = Sorting
+
+    @property
+    def StartTime(self):
+        return self._StartTime
+
+    @StartTime.setter
+    def StartTime(self, StartTime):
+        self._StartTime = StartTime
+
+    @property
+    def EndTime(self):
+        return self._EndTime
+
+    @EndTime.setter
+    def EndTime(self, EndTime):
+        self._EndTime = EndTime
+
+
+    def _deserialize(self, params):
+        self._DataEngineName = params.get("DataEngineName")
+        self._Limit = params.get("Limit")
+        self._Offset = params.get("Offset")
+        if params.get("Filters") is not None:
+            self._Filters = []
+            for item in params.get("Filters"):
+                obj = Filter()
+                obj._deserialize(item)
+                self._Filters.append(obj)
+        self._SortBy = params.get("SortBy")
+        self._Sorting = params.get("Sorting")
+        self._StartTime = params.get("StartTime")
+        self._EndTime = params.get("EndTime")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
+class DescribeTasksAnalysisResponse(AbstractModel):
+    """DescribeTasksAnalysis返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _TaskList: 洞察结果分页列表
+        :type TaskList: list of AnalysisTaskResults
+        :param _TotalCount: 洞察结果总数
+        :type TotalCount: int
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._TaskList = None
+        self._TotalCount = None
+        self._RequestId = None
+
+    @property
+    def TaskList(self):
+        return self._TaskList
+
+    @TaskList.setter
+    def TaskList(self, TaskList):
+        self._TaskList = TaskList
+
+    @property
+    def TotalCount(self):
+        return self._TotalCount
+
+    @TotalCount.setter
+    def TotalCount(self, TotalCount):
+        self._TotalCount = TotalCount
+
+    @property
+    def RequestId(self):
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        if params.get("TaskList") is not None:
+            self._TaskList = []
+            for item in params.get("TaskList"):
+                obj = AnalysisTaskResults()
+                obj._deserialize(item)
+                self._TaskList.append(obj)
+        self._TotalCount = params.get("TotalCount")
+        self._RequestId = params.get("RequestId")
+
+
 class DescribeTasksCostInfoRequest(AbstractModel):
     """DescribeTasksCostInfo请求参数结构体
 

tencentcloud/emr/v20190103/errorcodes.py

@@ -374,7 +374,7 @@ INVALIDPARAMETER_INVALIDTIMEUNIT = 'InvalidParameter.InvalidTimeUnit'
 # 无效的Tke集群ID，或Tke集群不符合条件。
 INVALIDPARAMETER_INVALIDTKEINSTANCE = 'InvalidParameter.InvalidTkeInstance'
 
-# 父帐号uin参数输入异常。
+# 父账号uin参数输入异常。
 INVALIDPARAMETER_INVALIDUINNUM = 'InvalidParameter.InvalidUinNum'
 
 # 无效的统一元数据库。

tencentcloud/emr/v20190103/models.py

@@ -6253,7 +6253,7 @@ class DescribeInsightListRequest(AbstractModel):
         :type PageSize: int
         :param _Page: 分页查询时的页号，从1开始
         :type Page: int
-        :param _Type: 查询类型,支持HIVE,SPARK,MAPREDUCE,TRINO等类型,默认查询全部
+        :param _Type: 查询类型,支持HIVE,SPARK,DLC_SPARK,SPARK_SQL,SCHEDULE,MAPREDUCE,TRINO等类型,默认查询全部
         :type Type: str
         """
         self._InstanceId = None
@@ -8152,99 +8152,7 @@ class DescribeYarnQueueResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Queue: 队列信息。是一个对象转成的json字符串，对应的golang结构体如下所示，比如`QueueWithConfigSetForFairScheduler`的第一个字段`Name`：
-
-```
-Name                         string                               `json:"name"` //队列名称
-```
-- `Name`：字段名
-- `string`：字段类型
-- `json:"name"`：表示在序列化和反序列化`json`时，对应的`json key`，下面以`json key`来指代
-- `//`：后面的注释内容对应页面上看到的名称
-
-字段类型以`*`开头的表示取值可能为json规范下的null，不同的语言需要使用能表达null的类型来接收，比如java的包装类型；字段类型以`[]`开头的表示是数组类型；`json key`在调用`ModifyYarnQueueV2 `接口也会使用。
-
-- 公平调度器
-
-```
-type QueueWithConfigSetForFairScheduler struct {
-	Name                         string                               `json:"name"` //队列名称
-	MyId                         string                  `json:"myId"` // 队列id，用于编辑、删除、克隆时使用
-	ParentId                     string                  `json:"parentId"`  // 父队列Id
-	Type                         *string                              `json:"type"` // 队列归属。parent或空，当确定某个队列是父队列，且没有子队列时，才可以设置，通常用来支持放置策略nestedUserQueue
-	AclSubmitApps                *AclForYarnQueue                     `json:"aclSubmitApps"` // 提交访问控制
-	AclAdministerApps            *AclForYarnQueue                     `json:"aclAdministerApps"` // 管理访问控制
-	MinSharePreemptionTimeout    *int                                 `json:"minSharePreemptionTimeout"` // 最小共享优先权超时时间
-	FairSharePreemptionTimeout   *int                                 `json:"fairSharePreemptionTimeout"` // 公平份额抢占超时时间
-	FairSharePreemptionThreshold *float32                             `json:"fairSharePreemptionThreshold"` // 公平份额抢占阈值。取值 （0，1]
-	AllowPreemptionFrom          *bool                                `json:"allowPreemptionFrom"`                                        // 抢占模式
-	SchedulingPolicy             *string                              `json:"schedulingPolicy"`  // 调度策略，取值有drf、fair、fifo
-	IsDefault                    *bool                                `json:"isDefault"` // 是否是root.default队列
-	IsRoot                       *bool                                `json:"isRoot"` // 是否是root队列
-	ConfigSets                   []ConfigSetForFairScheduler          `json:"configSets"` // 配置集设置
-	Children                     []QueueWithConfigSetForFairScheduler `json:"queues"` // 子队列信息。递归
-}
-
-type AclForYarnQueue struct {
-	User  *string `json:"user"` //用户名
-	Group *string `json:"group"`//组名
-}
-
-type ConfigSetForFairScheduler struct {
-	Name              string        `json:"name"` // 配置集名称
-	MinResources      *YarnResource `json:"minResources"` // 最小资源量
-	MaxResources      *YarnResource `json:"maxResources"` // 最大资源量
-	MaxChildResources *YarnResource `json:"maxChildResources"` // 能够分配给为未声明子队列的最大资源量
-	MaxRunningApps    *int          `json:"maxRunningApps"` // 最高可同时处于运行的App数量
-	Weight            *float32      `json:"weight"`                   // 权重
-	MaxAMShare        *float32      `json:"maxAMShare"` // App Master最大份额
-}
-
-type YarnResource struct {
-	Vcores *int `json:"vcores"`
-	Memory *int `json:"memory"`
-	Type *string `json:"type"` // 当值为`percent`时，表示使用的百分比，否则就是使用的绝对数值
-}
-```
-
-- 容量调度器
-
-```
-type QueueForCapacitySchedulerV3 struct {
-	Name                       string                `json:"name"` // 队列名称
-	MyId                       string                `json:"myId"` // 队列id，用于编辑、删除、克隆时使用
-	ParentId                   string                `json:"parentId"` // 父队列Id
-	Configs                    []ConfigForCapacityV3 `json:"configs"` //配置集设置
-	State                      *string         `json:"state"` // 资源池状态
-	DefaultNodeLabelExpression *string               `json:"default-node-label-expression"` // 默认标签表达式
-	AclSubmitApps              *AclForYarnQueue      `json:"acl_submit_applications"` // 提交访问控制
-	AclAdminQueue              *AclForYarnQueue      `json:"acl_administer_queue"` //管理访问控制
-	MaxAllocationMB *int32 `json:"maximum-allocation-mb"` // 分配Container最大内存数量
-	MaxAllocationVcores *int32                         `json:"maximum-allocation-vcores"` // Container最大vCore数量
-	IsDefault           *bool                          `json:"isDefault"`// 是否是root.default队列
-	IsRoot              *bool                          `json:"isRoot"` // 是否是root队列
-	Queues              []*QueueForCapacitySchedulerV3 `json:"queues"`//子队列信息。递归
-}
-type ConfigForCapacityV3 struct {
-	Name                string          `json:"configName"` // 配置集名称
-	Labels              []CapacityLabel `json:"labels"` // 标签信息
-	MinUserLimitPercent *int32          `json:"minimum-user-limit-percent"` // 用户最小容量
-	UserLimitFactor     *float32        `json:"user-limit-factor" valid:"rangeExcludeLeft(0|)"`  // 用户资源因子
-	MaxApps *int32 `json:"maximum-applications" valid:"rangeExcludeLeft(0|)"` // 最大应用数Max-Applications
-	MaxAmPercent               *float32 `json:"maximum-am-resource-percent"` // 最大AM比例
-	DefaultApplicationPriority *int32   `json:"default-application-priority"` // 资源池优先级
-}
-type CapacityLabel struct {
-	Name        string   `json:"labelName"`
-	Capacity    *float32 `json:"capacity"`  // 容量
-	MaxCapacity *float32 `json:"maximum-capacity"` //最大容量
-}
-
-type AclForYarnQueue struct {
-	User  *string `json:"user"` //用户名
-	Group *string `json:"group"`//组名
-}
-```
+        :param _Queue: 队列信息。是一个对象转成的json字符串，对应的golang结构体如下所示，例如`QueueWithConfigSetForFairScheduler`的第一个字段`Name`：```Name                         string                               `json:"name"` //队列名称```- `Name`：字段名- `string`：字段类型- `json:"name"`：表示在序列化和反序列化`json`时，对应的`json key`，下面以`json key`来指代- `//`：后面的注释内容对应页面上看到的名称字段类型以`*`开头的表示取值可能为json规范下的null，不同的语言需要使用能表达null的类型来接收，例如java的包装类型；字段类型以`[]`开头的表示是数组类型；`json key`在调用`ModifyYarnQueueV2 `接口也会使用。- 公平调度器```type QueueWithConfigSetForFairScheduler struct {	Name                         string                               `json:"name"` //队列名称	MyId                         string                  `json:"myId"` // 队列id，用于编辑、删除、克隆时使用	ParentId                     string                  `json:"parentId"`  // 父队列Id	Type                         *string                              `json:"type"` // 队列归属。parent或空，当确定某个队列是父队列，且没有子队列时，才可以设置，通常用来支持放置策略nestedUserQueue	AclSubmitApps                *AclForYarnQueue                     `json:"aclSubmitApps"` // 提交访问控制	AclAdministerApps            *AclForYarnQueue                     `json:"aclAdministerApps"` // 管理访问控制	MinSharePreemptionTimeout    *int                                 `json:"minSharePreemptionTimeout"` // 最小共享优先权超时时间	FairSharePreemptionTimeout   *int                                 `json:"fairSharePreemptionTimeout"` // 公平份额抢占超时时间	FairSharePreemptionThreshold *float32                             `json:"fairSharePreemptionThreshold"` // 公平份额抢占阈值。取值 （0，1]	AllowPreemptionFrom          *bool                                `json:"allowPreemptionFrom"`                                        // 抢占模式	SchedulingPolicy             *string                              `json:"schedulingPolicy"`  // 调度策略，取值有drf、fair、fifo	IsDefault                    *bool                                `json:"isDefault"` // 是否是root.default队列	IsRoot                       *bool                                `json:"isRoot"` // 是否是root队列	ConfigSets                   []ConfigSetForFairScheduler          `json:"configSets"` // 配置集设置	Children                     []QueueWithConfigSetForFairScheduler `json:"queues"` // 子队列信息。递归}type AclForYarnQueue struct {	User  *string `json:"user"` //用户名	Group *string `json:"group"`//组名}type ConfigSetForFairScheduler struct {	Name              string        `json:"name"` // 配置集名称	MinResources      *YarnResource `json:"minResources"` // 最小资源量	MaxResources      *YarnResource `json:"maxResources"` // 最大资源量	MaxChildResources *YarnResource `json:"maxChildResources"` // 能够分配给为未声明子队列的最大资源量	MaxRunningApps    *int          `json:"maxRunningApps"` // 最高可同时处于运行的App数量	Weight            *float32      `json:"weight"`                   // 权重	MaxAMShare        *float32      `json:"maxAMShare"` // App Master最大份额}type YarnResource struct {	Vcores *int `json:"vcores"`	Memory *int `json:"memory"`	Type *string `json:"type"` // 当值为`percent`时，表示使用的百分比，否则就是使用的绝对数值}```- 容量调度器```type QueueForCapacitySchedulerV3 struct {	Name                       string                `json:"name"` // 队列名称	MyId                       string                `json:"myId"` // 队列id，用于编辑、删除、克隆时使用	ParentId                   string                `json:"parentId"` // 父队列Id	Configs                    []ConfigForCapacityV3 `json:"configs"` //配置集设置	State                      *string         `json:"state"` // 资源池状态	DefaultNodeLabelExpression *string               `json:"default-node-label-expression"` // 默认标签表达式	AclSubmitApps              *AclForYarnQueue      `json:"acl_submit_applications"` // 提交访问控制	AclAdminQueue              *AclForYarnQueue      `json:"acl_administer_queue"` //管理访问控制	MaxAllocationMB *int32 `json:"maximum-allocation-mb"` // 分配Container最大内存数量	MaxAllocationVcores *int32                         `json:"maximum-allocation-vcores"` // Container最大vCore数量	IsDefault           *bool                          `json:"isDefault"`// 是否是root.default队列	IsRoot              *bool                          `json:"isRoot"` // 是否是root队列	Queues              []*QueueForCapacitySchedulerV3 `json:"queues"`//子队列信息。递归}type ConfigForCapacityV3 struct {	Name                string          `json:"configName"` // 配置集名称	Labels              []CapacityLabel `json:"labels"` // 标签信息	MinUserLimitPercent *int32          `json:"minimum-user-limit-percent"` // 用户最小容量	UserLimitFactor     *float32        `json:"user-limit-factor" valid:"rangeExcludeLeft(0|)"`  // 用户资源因子	MaxApps *int32 `json:"maximum-applications" valid:"rangeExcludeLeft(0|)"` // 最大应用数Max-Applications	MaxAmPercent               *float32 `json:"maximum-am-resource-percent"` // 最大AM比例	DefaultApplicationPriority *int32   `json:"default-application-priority"` // 资源池优先级}type CapacityLabel struct {	Name        string   `json:"labelName"`	Capacity    *float32 `json:"capacity"`  // 容量	MaxCapacity *float32 `json:"maximum-capacity"` //最大容量}type AclForYarnQueue struct {	User  *string `json:"user"` //用户名	Group *string `json:"group"`//组名}```
         :type Queue: str
         :param _Version: 版本
         :type Version: str

tencentcloud/ess/v20201111/ess_client.py

@@ -27,7 +27,17 @@ class EssClient(AbstractClient):
 
 
     def ArchiveDynamicFlow(self, request):
-        """该接口用于结束动态签署流程，若当前合同还存在签署方未签署，无法结束。
+        """该接口用于结束动态签署方2.0的合同流程。
+
+
+        **功能开通**
+        - 动态签署方2.0功能的使用需要先<font color="red">联系产品经理开通模块化计费功能</font>，然后到控制台中打开此功能。详细的使用说明请参考<a href="https://qian.tencent.com/developers/company/dynamic_signer_v2" target="_blank">动态签署方2.0</a>文档。
+
+        **使用条件**
+        - 此接口只能在<font color="red">合同处于非终态且<b>所有的签署方都已经完成签署</b></font>。一旦合同进入终态（例如：过期、拒签、撤销或者调用过此接口成功过），将无法通过此接口结束合同流程。
+
+        **整体流程**
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/75d323c66e44b05bbc8e949c18664455.png)
 
         :param request: Request instance for ArchiveDynamicFlow.
         :type request: :class:`tencentcloud.ess.v20201111.models.ArchiveDynamicFlowRequest`
@@ -458,8 +468,20 @@ class EssClient(AbstractClient):
 
 
     def CreateDynamicFlowApprover(self, request):
-        """此接口（CreateDynamicFlowApprover）用来补充动态合同的签署人信息。<br/>
-        适用场景：使用CreateFlowByFiles指定：OpenDynamicSignFlow=true发起的合同，可以使用该接口补充后续签署人。<br/>
+        """此接口（CreateDynamicFlowApprover）接口主要用于补充动态签署方2.0合同的签署方信息，包括但不限于名字、手机号和签署区域等信息。
+
+
+        **功能开通**
+        动态签署方2.0功能的使用需要先<font color="red">联系产品经理开通模块化计费功能</font>，然后到控制台中打开此功能。详细的使用说明请参考<a href="https://qian.tencent.com/developers/company/dynamic_signer_v2" target="_blank">动态签署方2.0</a>文档。
+
+        **使用条件**
+        - 在发起合同时，必须将OpenDynamicSignFlow参数设置为true，以确保合同以动态签署方2.0的方式处理，否则默认处理为普通合同。
+        - 此接口只能在合同处于非终态时调用。一旦合同进入终态（例如：过期、拒签或撤销），将无法通过此接口添加新的签署方。
+
+
+        动态签署方2.0合同<font color="red">不会自动结束（整个合同变为签署完成）</font>，需要通过调用<a href="https://qian.tencent.com/developers/companyApis/operateFlows/ArchiveDynamicFlow/" target="_blank">结束动态签署合同</a>来手动结束签署流程。整体的流程如下图
+
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/75d323c66e44b05bbc8e949c18664455.png)
 
         :param request: Request instance for CreateDynamicFlowApprover.
         :type request: :class:`tencentcloud.ess.v20201111.models.CreateDynamicFlowApproverRequest`
@@ -647,7 +669,7 @@ class EssClient(AbstractClient):
 
         ![image](https://qcloudimg.tencent-cloud.cn/raw/b2715f0236faee807cfc0521f93cf01b.png)
 
-        <b><font color="red">2. 动态签署人合同</font>: 若未指定具体签署人的信息，则合同变成动态签署人合同</b>。需调用此接口补充或添加签署人。可以参考文档    [动态签署人合同](https://qian.tencent.com/developers/company/dynamic_signer/)    。动态签署人在控制台上的展示样式如下：
+        <b><font color="red">2. 动态签署人合同</font>: 若未指定具体签署人的信息，则合同变成动态签署人合同</b>。需调用此接口补充或添加签署人。可以参考文档    <a href="https://qian.tencent.com/developers/company/dynamic_signer/" target="_blank">动态签署人合同</a>   。动态签署人在控制台上的展示样式如下：
 
         ![image](https://qcloudimg.tencent-cloud.cn/raw/2729477978e020c3bbb4d2e767bb78eb.png)
 
@@ -2516,8 +2538,15 @@ class EssClient(AbstractClient):
 
 
     def DescribeUserVerifyStatus(self, request):
-        """用于客户企业在调用生成[C端用户实名链接（CreateUserVerifyUrl）](https://qian.tencent.com/developers/companyApis/users/CreateUserVerifyUrl)接口之前判断C端用户是否实名，如果已经实名，就不需要再次调用生成C端链接接口去实名
-        注意：此接口仅会返回当前员工是否通过[C端用户实名链接（CreateUserVerifyUrl）](https://qian.tencent.com/developers/companyApis/users/CreateUserVerifyUrl)所实名的员工是否实名，并不会返回个人用户自己在电子签进行实名的状况
+        """检测个人用户是否已经实名。
+
+        在调用生成C端用户实名链接（[CreateUserVerifyUrl](https://qian.tencent.com/developers/companyApis/users/CreateUserVerifyUrl)）接口之前，客户企业应首先调用本接口判断C端用户是否已经完成实名认证。如果用户已经实名，那么无需再次调用（[CreateUserVerifyUrl](https://qian.tencent.com/developers/companyApis/users/CreateUserVerifyUrl)）生成链接并走实名认证流程。
+
+        注意：
+
+        - 此接口<font color="red">仅用于确认通过本公司生成[C端用户实名链接（CreateUserVerifyUrl）](https://qian.tencent.com/developers/companyApis/users/CreateUserVerifyUrl)接口注册认证的用户，不包括其他途径（如主动注册认证、在签署合同中注册认证等）在电子签平台上进行的实名认证</font>。
+
+        - 调用此接口需要购买单独的实名套餐包。<font color="red">使用前请联系对接的客户经理沟通</font>。
 
         :param request: Request instance for DescribeUserVerifyStatus.
         :type request: :class:`tencentcloud.ess.v20201111.models.DescribeUserVerifyStatusRequest`