tccli 3.0.847.1__py2.py3-none-any.whl → 3.0.849.1__py2.py3-none-any.whl

tccli/services/thpc/v20230321/examples.json

@@ -0,0 +1,125 @@
+{
+  "actions": {
+    "AddClusterStorageOption": [
+      {
+        "document": "集群添加CFS挂载选项。",
+        "input": "POST / HTTP/1.1\nHost: thpc.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: AddClusterStorageOption\n<公共请求参数>\n\n{\n    \"ClusterId\": \"hpc-eq97tf4u\",\n    \"StorageOption\": {\n        \"CFSOptions\": [\n            {\n                \"LocalPath\": \"/data/\",\n                \"RemotePath\": \"172.30.3.90:/\",\n                \"Protocol\": \"NFS 4.0\",\n                \"StorageType\": \"SD\"\n            },\n            {\n                \"LocalPath\": \"/tmp/\",\n                \"RemotePath\": \"172.30.2.180@tcp0:/4fe1839b/cfs\",\n                \"Protocol\": \"TURBO\",\n                \"StorageType\": \"TB\"\n            }\n        ]\n    }\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"b2ac2379-6453-4eab-8f63-7ade00cb67b0\"\n    }\n}",
+        "title": "添加集群存储选项"
+      }
+    ],
+    "AddNodes": [
+      {
+        "document": "往集群ID为hpc-52nkfau6的集群的compute队列增加一个计算节点。",
+        "input": "POST / HTTP/1.1\nHost: thpc.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: AddNodes\n<公共请求参数>\n\n{\n    \"Count\": \"1\",\n    \"VirtualPrivateCloud\": {\n        \"SubnetId\": \"subnet-r0zpktaa\",\n        \"VpcId\": \"vpc-r9jw2jzr\"\n    },\n    \"Placement\": {\n        \"Zone\": \"ap-guangzhou-2\"\n    },\n    \"ClusterId\": \"hpc-52nkfau6\",\n    \"ImageId\": \"img-3la7wgnt\",\n    \"InstanceChargeType\": \"SPOTPAID\",\n    \"InstanceType\": \"S2.SMALL2\",\n    \"NodeRole\": \"Compute\",\n    \"QueueName\": \"compute\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"b2ac2379-6453-4eab-8f63-7ade00cb67b0\"\n    }\n}",
+        "title": "添加节点"
+      }
+    ],
+    "AddQueue": [
+      {
+        "document": "往指定集群添加队列。",
+        "input": "POST / HTTP/1.1\nHost: thpc.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: AddQueue\n<公共请求参数>\n\n{\n    \"ClusterId\": \"hpc-prkxbd7c\",\n    \"QueueName\": \"gpu\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"13ee84a5-7846-4682-8877-1c8f94962dd6\"\n    }\n}",
+        "title": "添加队列"
+      }
+    ],
+    "CreateCluster": [
+      {
+        "document": "创建一个管控节点和两个计算节点的集群。调度器为：SLURM。",
+        "input": "POST / HTTP/1.1\nHost: thpc.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateCluster\n<公共请求参数>\n\n{\n    \"ManagerNodeCount\": \"1\",\n    \"Placement\": {\n        \"Zone\": \"ap-guangzhou-2\"\n    },\n    \"SchedulerType\": \"SLURM\",\n    \"ImageId\": \"img-3la7wgnt\",\n    \"ComputeNode\": {\n        \"InstanceChargeType\": \"SPOTPAID\",\n        \"InstanceType\": \"S2.SMALL2\"\n    },\n    \"ComputeNodeCount\": \"2\",\n    \"ManagerNode\": {\n        \"InstanceType\": \"S2.SMALL2\"\n    }\n}",
+        "output": "{\n    \"Response\": {\n        \"ClusterId\": \"hpc-5lyv94lq\",\n        \"RequestId\": \"b2ac2379-6453-4eab-8f63-7ade00cb67b0\"\n    }\n}",
+        "title": "创建集群"
+      }
+    ],
+    "DeleteCluster": [
+      {
+        "document": "删除指定集群。",
+        "input": "https://thpc.tencentcloudapi.com/?Action=DeleteCluster\n&ClusterId=hpc-5lyv94lq\n&<公共请求参数>",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"8b71050a-55c1-4f3b-bf66-5e4f8510a5a0\"\n    }\n}",
+        "title": "删除集群"
+      }
+    ],
+    "DeleteClusterStorageOption": [
+      {
+        "document": "删除本地挂载点为/data/的存储选项信息。",
+        "input": "POST / HTTP/1.1\nHost: thpc.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DeleteClusterStorageOption\n<公共请求参数>\n\n{\n    \"ClusterId\": \"hpc-5lyv94lq\",\n    \"LocalPath\": \"/data/\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"2aeaea7e-9fc4-4c17-8a9b-50343b711003\"\n    }\n}",
+        "title": "删除集群存储选项信息。"
+      }
+    ],
+    "DeleteNodes": [
+      {
+        "document": "批量删除节点。",
+        "input": "https://thpc.tencentcloudapi.com/?Action=DeleteNodes\n&ClusterId=hpc-5lyv94lq\n&NodeIds.0=ins-jhf9c1gi\n&NodeIds.1=ins-qmzlqk70\n&<公共请求参数>",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"f4d90874-f565-463d-ba1d-c707517eeaa1\"\n    }\n}",
+        "title": "删除节点"
+      }
+    ],
+    "DeleteQueue": [
+      {
+        "document": "从集群删除指定队列。",
+        "input": "POST / HTTP/1.1\nHost: thpc.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DeleteQueue\n<公共请求参数>\n\n{\n    \"ClusterId\": \"hpc-prkxbd7c\",\n    \"QueueName\": \"compute\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"13ee84a5-7846-4682-8877-1c8f94962d10\"\n    }\n}",
+        "title": "删除队列"
+      }
+    ],
+    "DescribeAutoScalingConfiguration": [
+      {
+        "document": "查询集群ID为hpc-rv7hahw2的集群弹性伸缩配置信息。",
+        "input": "POST / HTTP/1.1\nHost: thpc.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeAutoScalingConfiguration\n<公共请求参数>\n\n{\n    \"ClusterId\": \"hpc-rv7hahw2\"\n}",
+        "output": "{\n    \"Response\": {\n        \"ClusterId\": \"hpc-rv7hahw2\",\n        \"ExpansionBusyTime\": 120,\n        \"ShrinkIdleTime\": 300,\n        \"QueueConfigs\": [\n            {\n                \"QueueName\": \"compute\",\n                \"MinSize\": 0,\n                \"MaxSize\": 10,\n                \"EnableAutoExpansion\": false,\n                \"EnableAutoShrink\": false,\n                \"ExpansionNodeConfigs\": [\n                    {\n                        \"InstanceType\": \"M5.SMALL8\",\n                        \"Placement\": {\n                            \"Zone\": \"ap-chongqing-1\"\n                        },\n                        \"InstanceChargeType\": \"POSTPAID_BY_HOUR\",\n                        \"InstanceChargePrepaid\": null,\n                        \"VirtualPrivateCloud\": {\n                            \"VpcId\": \"vpc-r9jw2jzv\",\n                            \"SubnetId\": \"subnet-r0zpktae\"\n                        },\n                        \"ImageId\": \"img-l8og963d\",\n                        \"InternetAccessible\": {\n                            \"InternetChargeType\": \"TRAFFIC_POSTPAID_BY_HOUR\",\n                            \"InternetMaxBandwidthOut\": 0\n                        },\n                        \"SystemDisk\": {\n                            \"DiskType\": \"CLOUD_BSSD\",\n                            \"DiskSize\": 50\n                        },\n                        \"DataDisks\": null\n                    }\n                ]\n            }\n        ],\n        \"RequestId\": \"935760b6-2a63-480d-9124-c5f5b9d4218b\"\n    }\n}",
+        "title": "查询扩缩容策略配置"
+      }
+    ],
+    "DescribeClusterActivities": [
+      {
+        "document": "根据集群ID查询集群活动历史记录。",
+        "input": "POST / HTTP/1.1\nHost: thpc.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeClusterActivities\n<公共请求参数>\n\n{\n    \"ClusterId\": \"hpc-0yd8fqsc\",\n    \"Limit\": \"1\",\n    \"Offset\": \"0\"\n}",
+        "output": "{\n    \"Response\": {\n        \"ClusterActivitySet\": [\n            {\n                \"ClusterId\": \"hpc-myd8fgsc\",\n                \"ActivityId\": \"cha-gvzj0zbd\",\n                \"ActivityType\": \"TerminateNodes\",\n                \"ActivityStatus\": \"SUCCESSFUL\",\n                \"ActivityStatusCode\": \"ActivitySuccess\",\n                \"ResultDetail\": \"Activity success.\",\n                \"Cause\": \"DeleteCluster\",\n                \"Description\": \"删除指定集群，销毁实例，销毁所有节点。\",\n                \"RelatedNodeActivitySet\": [\n                    {\n                        \"NodeInstanceId\": \"ins-1zll2of0\",\n                        \"NodeActivityStatus\": \"SUCCESSFUL\",\n                        \"NodeActivityStatusCode\": \"ActivitySuccess\",\n                        \"NodeActivityStatusReason\": \"Activity success.\"\n                    },\n                    {\n                        \"NodeInstanceId\": \"ins-ig2bew40\",\n                        \"NodeActivityStatus\": \"SUCCESSFUL\",\n                        \"NodeActivityStatusCode\": \"ActivitySuccess\",\n                        \"NodeActivityStatusReason\": \"Activity success.\"\n                    }\n                ],\n                \"StartTime\": \"2021-11-01T02:17:20Z\",\n                \"EndTime\": \"2021-11-01T02:17:38Z\"\n            }\n        ],\n        \"TotalCount\": 1,\n        \"RequestId\": \"7fa864e6-cf1a-4962-8aa9-f68abfa31a00\"\n    }\n}",
+        "title": "查询集群活动历史记录"
+      }
+    ],
+    "DescribeClusterStorageOption": [
+      {
+        "document": "查询集群ID为hpc-5lyv94lq的集群存储选项信息。",
+        "input": "POST / HTTP/1.1\nHost: thpc.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeClusterStorageOption\n<公共请求参数>\n\n{\n    \"ClusterId\": \"hpc-5lyv94lq\"\n}",
+        "output": "{\n    \"Response\": {\n        \"StorageOption\": {\n            \"CFSOptions\": [\n                {\n                    \"LocalPath\": \"/opt/\",\n                    \"RemotePath\": \"172.30.3.90:/j25ey5tz/hpc-kjddsnfa/opt/\",\n                    \"Protocol\": \"NFS 3.0\",\n                    \"StorageType\": \"SD\"\n                }\n            ],\n            \"GooseFSOptions\": [\n                {\n                    \"LocalPath\": \"/data/\",\n                    \"RemotePath\": \"/\",\n                    \"Masters\": [\n                        \"172.30.4.63:9202\",\n                        \"172.30.0.128:9202\"\n                    ]\n                }\n            ]\n        },\n        \"RequestId\": \"2aeaea7e-9fc4-4c17-8a9b-50343b712993\"\n    }\n}",
+        "title": "查询集群存储选项"
+      }
+    ],
+    "DescribeClusters": [
+      {
+        "document": "查询集群列表。",
+        "input": "https://thpc.tencentcloudapi.com/?Action=DescribeClusters\n&Offset=0\n&Limit=1\n&<公共请求参数>",
+        "output": "{\n    \"Response\": {\n        \"ClusterSet\": [\n            {\n                \"ClusterId\": \"hpc-qrb7ybn0\",\n                \"ClusterName\": \"unnamed\",\n                \"ClusterStatus\": \"RUNNING\",\n                \"Placement\": {\n                    \"Zone\": \"ap-guangzhou-2\"\n                },\n                \"CreateTime\": \"2021-12-07T03:29:09Z\",\n                \"SchedulerType\": \"SGE\",\n                \"VpcId\": \"vpc-xxxxxxxx\",\n                \"ComputeNodeCount\": 1,\n                \"LoginNodeSet\": [\n                    {\n                        \"NodeId\": \"ins-jehc407m\"\n                    }\n                ],\n                \"LoginNodeCount\": 1,\n                \"ComputeNodeSet\": [\n                    {\n                        \"NodeId\": \"ins-jfhc307q\"\n                    }\n                ],\n                \"ManagerNodeCount\": 1,\n                \"ManagerNodeSet\": [\n                    {\n                        \"NodeId\": \"ins-cv6ygpkq\"\n                    }\n                ]\n            }\n        ],\n        \"TotalCount\": 1,\n        \"RequestId\": \"8a39c8e3-129b-4628-b763-ef96caaa2f4d\"\n    }\n}",
+        "title": "查询集群列表"
+      }
+    ],
+    "DescribeNodes": [
+      {
+        "document": "查询指定集群节点概览信息，集群ID为hpc-ggaqjyax。",
+        "input": "https://thpc.tencentcloudapi.com/?Action=DescribeNodes\n&ClusterId=hpc-ggaqjyax\n&Offset=0\n&Limit=1\n&<公共请求参数>",
+        "output": "{\n    \"Response\": {\n        \"NodeSet\": [\n            {\n                \"InstanceId\": \"ins-j3n6kiae\",\n                \"Zone\": \"ap-chongqing-1\",\n                \"NodeState\": \"RUNNING\",\n                \"ImageId\": \"img-l8og963d\",\n                \"QueueName\": \"compute\",\n                \"NodeRole\": \"Compute\",\n                \"NodeType\": \"DYNAMIC\"\n            }\n        ],\n        \"TotalCount\": 3,\n        \"RequestId\": \"6793673e-3bce-4fbb-adea-923a82267da2\"\n    }\n}",
+        "title": "查询指定集群节点概览信息。"
+      }
+    ],
+    "DescribeQueues": [
+      {
+        "document": "查询集群队列概览信息列表。",
+        "input": "POST / HTTP/1.1\nHost: thpc.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeQueues\n<公共请求参数>\n\n{\n    \"ClusterId\": \"hpc-prkxbd7c\",\n    \"Offset\": 0,\n    \"Limit\": 20\n}",
+        "output": "{\n    \"Response\": {\n        \"QueueSet\": [\n            {\n                \"QueueName\": \"compute\"\n            }\n        ],\n        \"TotalCount\": 1,\n        \"RequestId\": \"13ee84a5-7846-4682-8877-1c8f94962dd5\"\n    }\n}",
+        "title": "查询集群队列概览信息列表"
+      }
+    ],
+    "SetAutoScalingConfiguration": [
+      {
+        "document": "集群配置弹性伸缩策略信息。",
+        "input": "POST / HTTP/1.1\nHost: thpc.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: SetAutoScalingConfiguration\n<公共请求参数>\n\n{\n    \"DryRun\": \"false\",\n    \"ShrinkIdleTime\": \"300\",\n    \"ExpansionBusyTime\": \"120\",\n    \"ClusterId\": \"hpc-5lyv94lq\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"d1d90874-f565-463d-ba1d-c707517eece1\"\n    }\n}",
+        "title": "设置弹性伸缩配置"
+      }
+    ]
+  },
+  "version": "1.0"
+}

tccli/services/tiw/tiw_client.py

@@ -277,6 +277,58 @@ def doSetVideoGenerationTaskCallback(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doDescribeRecordSearch(args, parsed_globals):
+    g_param = parse_global_arg(parsed_globals)
+
+    if g_param[OptionsDefine.UseCVMRole.replace('-', '_')]:
+        cred = credential.CVMRoleCredential()
+    elif g_param[OptionsDefine.RoleArn.replace('-', '_')] and g_param[OptionsDefine.RoleSessionName.replace('-', '_')]:
+        cred = credential.STSAssumeRoleCredential(
+            g_param[OptionsDefine.SecretId], g_param[OptionsDefine.SecretKey], g_param[OptionsDefine.RoleArn.replace('-', '_')],
+            g_param[OptionsDefine.RoleSessionName.replace('-', '_')]
+        )
+    elif os.getenv(OptionsDefine.ENV_TKE_REGION)             and os.getenv(OptionsDefine.ENV_TKE_PROVIDER_ID)             and os.getenv(OptionsDefine.ENV_TKE_IDENTITY_TOKEN_FILE)             and os.getenv(OptionsDefine.ENV_TKE_ROLE_ARN):
+        cred = credential.DefaultTkeOIDCRoleArnProvider().get_credentials()
+    else:
+        cred = credential.Credential(
+            g_param[OptionsDefine.SecretId], g_param[OptionsDefine.SecretKey], g_param[OptionsDefine.Token]
+        )
+    http_profile = HttpProfile(
+        reqTimeout=60 if g_param[OptionsDefine.Timeout] is None else int(g_param[OptionsDefine.Timeout]),
+        reqMethod="POST",
+        endpoint=g_param[OptionsDefine.Endpoint],
+        proxy=g_param[OptionsDefine.HttpsProxy.replace('-', '_')]
+    )
+    profile = ClientProfile(httpProfile=http_profile, signMethod="HmacSHA256")
+    if g_param[OptionsDefine.Language]:
+        profile.language = g_param[OptionsDefine.Language]
+    mod = CLIENT_MAP[g_param[OptionsDefine.Version]]
+    client = mod.TiwClient(cred, g_param[OptionsDefine.Region], profile)
+    client._sdkVersion += ("_CLI_" + __version__)
+    models = MODELS_MAP[g_param[OptionsDefine.Version]]
+    model = models.DescribeRecordSearchRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.DescribeRecordSearch(model)
+        result = rsp.to_json_string()
+        try:
+            json_obj = json.loads(result)
+        except TypeError as e:
+            json_obj = json.loads(result.decode('utf-8'))  # python3.3
+        if not g_param[OptionsDefine.Waiter] or search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj) == g_param['OptionsDefine.WaiterInfo']['to']:
+            break
+        cur_time = time.time()
+        if cur_time - start_time >= g_param['OptionsDefine.WaiterInfo']['timeout']:
+            raise ClientError('Request timeout, wait `%s` to `%s` timeout, last request is %s' %
+            (g_param['OptionsDefine.WaiterInfo']['expr'], g_param['OptionsDefine.WaiterInfo']['to'],
+            search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj)))
+        else:
+            print('Inquiry result is %s.' % search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj))
+        time.sleep(g_param['OptionsDefine.WaiterInfo']['interval'])
+    FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
+
+
 def doCreateVideoGenerationTask(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -2841,6 +2893,7 @@ ACTION_MAP = {
     "DescribeBoardSDKLog": doDescribeBoardSDKLog,
     "DescribeUserList": doDescribeUserList,
     "SetVideoGenerationTaskCallback": doSetVideoGenerationTaskCallback,
+    "DescribeRecordSearch": doDescribeRecordSearch,
     "CreateVideoGenerationTask": doCreateVideoGenerationTask,
     "StopOnlineRecord": doStopOnlineRecord,
     "DescribeWhiteboardApplicationConfig": doDescribeWhiteboardApplicationConfig,

tccli/services/tiw/v20190919/api.json

@@ -119,6 +119,13 @@
       "output": "DescribeQualityMetricsResponse",
       "status": "online"
     },
+    "DescribeRecordSearch": {
+      "document": "根据房间号搜索实时录制任务",
+      "input": "DescribeRecordSearchRequest",
+      "name": "搜索实时录制任务",
+      "output": "DescribeRecordSearchResponse",
+      "status": "online"
+    },
     "DescribeRoomList": {
       "document": "查询白板房间列表",
       "input": "DescribeRoomListRequest",
@@ -1684,6 +1691,41 @@
       ],
       "type": "object"
     },
+    "DescribeRecordSearchRequest": {
+      "document": "DescribeRecordSearch请求参数结构体",
+      "members": [],
+      "type": "object"
+    },
+    "DescribeRecordSearchResponse": {
+      "document": "DescribeRecordSearch返回参数结构体",
+      "members": [
+        {
+          "document": "录制任务搜索结果集合",
+          "example": "无",
+          "member": "RecordTaskSearchResult",
+          "name": "RecordTaskSet",
+          "required": true,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "document": "录制总任务数",
+          "example": "151",
+          "member": "int64",
+          "name": "TotalCount",
+          "required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "DescribeRoomListRequest": {
       "document": "DescribeRoomList请求参数结构体",
       "members": [
@@ -3279,6 +3321,180 @@
       ],
       "usage": "in"
     },
+    "RecordTaskResult": {
+      "document": "实时录制结果",
+      "members": [
+        {
+          "default": "",
+          "document": "AUTO - 自动停止录制， USER_CALL - 用户主动调用停止录制",
+          "member": "string",
+          "name": "FinishReason",
+          "required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "异常数",
+          "member": "int64",
+          "name": "ExceptionCnt",
+          "required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "房间号",
+          "member": "int64",
+          "name": "RoomId",
+          "required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "分组",
+          "member": "string",
+          "name": "GroupId",
+          "required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "录制真实开始时间",
+          "member": "int64",
+          "name": "RecordStartTime",
+          "required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "录制结束时间",
+          "member": "int64",
+          "name": "RecordStopTime",
+          "required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "录制总时长",
+          "member": "int64",
+          "name": "TotalTime",
+          "required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "视频信息列表",
+          "member": "VideoInfo",
+          "name": "VideoInfos",
+          "required": true,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "被忽略的视频时间段",
+          "member": "OmittedDuration",
+          "name": "OmittedDurations",
+          "required": true,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "详情",
+          "member": "string",
+          "name": "Details",
+          "required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "任务失败错误码",
+          "member": "int64",
+          "name": "ErrorCode",
+          "required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "错误信息",
+          "member": "string",
+          "name": "ErrorMsg",
+          "required": true,
+          "type": "string",
+          "value_allowed_null": false
+        }
+      ],
+      "usage": "out"
+    },
+    "RecordTaskSearchResult": {
+      "document": "实时录制任务搜索结果",
+      "members": [
+        {
+          "default": "",
+          "document": "任务唯一ID",
+          "member": "string",
+          "name": "TaskId",
+          "required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "实时录制任务状态\n- PAUSED: 录制已暂停\n- PREPARED: 录制在准备阶段\n- RECORDING: 正在录制\n- STOPPED：录制已停止\n- FINISHED: 录制已结束",
+          "member": "string",
+          "name": "Status",
+          "required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "实时录制房间号",
+          "member": "int64",
+          "name": "RoomId",
+          "required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "任务创建时间",
+          "member": "datetime_iso",
+          "name": "CreateTime",
+          "required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "用户应用SdkAppId",
+          "member": "int64",
+          "name": "SdkAppId",
+          "required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "default": "",
+          "document": "实时录制结果",
+          "member": "RecordTaskResult",
+          "name": "Result",
+          "required": true,
+          "type": "object",
+          "value_allowed_null": false
+        }
+      ],
+      "usage": "out"
+    },
     "ResumeOnlineRecordRequest": {
       "document": "ResumeOnlineRecord请求参数结构体",
       "members": [

tccli/services/tiw/v20190919/examples.json

@@ -148,6 +148,14 @@
         "title": "查询白板图片加载失败统计"
       }
     ],
+    "DescribeRecordSearch": [
+      {
+        "document": "",
+        "input": "https://tiw.tencentcloudapi.com/?Action=DescribeRecordSearch\n&Offset=0\n&Limit=1\n&RoomId=880528\n&<公共请求参数>",
+        "output": "{\n    \"Response\": {\n        \"RecordTaskSet\": [\n            {\n                \"CreateTime\": \"2020-08-24T21:53:56+08:00\",\n                \"RoomId\": 880528,\n                \"TaskId\": \"gvft1qbrvs2331tcs1tb\",\n                \"Status\": \"FINISHED\",\n                \"SdkAppId\": 1400127140,\n                \"Result\": {\n                    \"FinishReason\": \"USER_CALL\",\n                    \"ExceptionCnt\": 0,\n                    \"RoomId\": 880528,\n                    \"GroupId\": \"880528\",\n                    \"RecordStartTime\": 1598277240,\n                    \"RecordStopTime\": 1598277614,\n                    \"TotalTime\": 368433,\n                    \"VideoInfos\": [\n                        {\n                            \"VideoDuration\": 368332,\n                            \"UserId\": \"\",\n                            \"VideoSize\": 10731806,\n                            \"VideoUrl\": \"http://whiteboard-cam-test-1257307760.cos.ap-nanjing.myqcloud.com/video/gvft1qbrvs2331tcs1tb/0cf156ea197a8012073e6b690f44e530.mp4\",\n                            \"VideoType\": 2,\n                            \"VideoPlayTime\": 0,\n                            \"VideoFormat\": \"mp4\",\n                            \"VideoId\": \"0cf156ea197a8012073e6b690f44e530\",\n                            \"Width\": 1280,\n                            \"Height\": 960\n                        },\n                        {\n                            \"VideoDuration\": 368325,\n                            \"UserId\": \"tic_mixstream_880528_custom\",\n                            \"VideoSize\": 12276476,\n                            \"VideoUrl\": \"http://whiteboard-cam-test-1257307760.cos.ap-nanjing.myqcloud.com/video/gvft1qbrvs2331tcs1tb/ae62799da16a83ab9eb3da0bb37ef89f.mp4\",\n                            \"VideoType\": 3,\n                            \"VideoPlayTime\": 108,\n                            \"VideoFormat\": \"mp4\",\n                            \"VideoId\": \"ae62799da16a83ab9eb3da0bb37ef89f\",\n                            \"Width\": 1624,\n                            \"Height\": 1000\n                        },\n                        {\n                            \"VideoDuration\": 181102,\n                            \"UserId\": \"tic_mixstream_880528_101\",\n                            \"VideoSize\": 3743450,\n                            \"VideoUrl\": \"http://whiteboard-cam-test-1257307760.cos.ap-nanjing.myqcloud.com/video/gvft1qbrvs2331tcs1tb/54797f6b83940a708c7b7aecc2f1d1a9.mp4\",\n                            \"VideoType\": 3,\n                            \"VideoPlayTime\": 28918,\n                            \"VideoFormat\": \"mp4\",\n                            \"VideoId\": \"54797f6b83940a708c7b7aecc2f1d1a9\",\n                            \"Width\": 496,\n                            \"Height\": 368\n                        },\n                        {\n                            \"VideoDuration\": 35405,\n                            \"UserId\": \"tiw_web_736\",\n                            \"VideoSize\": 3001045,\n                            \"VideoUrl\": \"http://whiteboard-cam-test-1257307760.cos.ap-nanjing.myqcloud.com/video/gvft1qbrvs2331tcs1tb/7e562e9d513d12a2e03bea1514cc40fc.mp4\",\n                            \"VideoType\": 0,\n                            \"VideoPlayTime\": 29475,\n                            \"VideoFormat\": \"mp4\",\n                            \"VideoId\": \"7e562e9d513d12a2e03bea1514cc40fc\",\n                            \"Width\": 1280,\n                            \"Height\": 720\n                        },\n                        {\n                            \"VideoDuration\": 161885,\n                            \"UserId\": \"tiw_web_310\",\n                            \"VideoSize\": 9974368,\n                            \"VideoUrl\": \"http://whiteboard-cam-test-1257307760.cos.ap-nanjing.myqcloud.com/video/gvft1qbrvs2331tcs1tb/9ba564cba92925a02a88ef3ee874b586.mp4\",\n                            \"VideoType\": 0,\n                            \"VideoPlayTime\": 47535,\n                            \"VideoFormat\": \"mp4\",\n                            \"VideoId\": \"9ba564cba92925a02a88ef3ee874b586\",\n                            \"Width\": 1280,\n                            \"Height\": 720\n                        },\n                        {\n                            \"VideoDuration\": 6085,\n                            \"UserId\": \"tiw_web_736\",\n                            \"VideoSize\": 283329,\n                            \"VideoUrl\": \"http://whiteboard-cam-test-1257307760.cos.ap-nanjing.myqcloud.com/video/gvft1qbrvs2331tcs1tb/9517ed0696f910865ecaf22a07be4c0f.mp4\",\n                            \"VideoType\": 0,\n                            \"VideoPlayTime\": 64903,\n                            \"VideoFormat\": \"mp4\",\n                            \"VideoId\": \"9517ed0696f910865ecaf22a07be4c0f\",\n                            \"Width\": 960,\n                            \"Height\": 540\n                        },\n                        {\n                            \"VideoDuration\": 96787,\n                            \"UserId\": \"tiw_web_736\",\n                            \"VideoSize\": 5604352,\n                            \"VideoUrl\": \"http://whiteboard-cam-test-1257307760.cos.ap-nanjing.myqcloud.com/video/gvft1qbrvs2331tcs1tb/cdda0043fb734600d14324c4364213e2.mp4\",\n                            \"VideoType\": 0,\n                            \"VideoPlayTime\": 115401,\n                            \"VideoFormat\": \"mp4\",\n                            \"VideoId\": \"cdda0043fb734600d14324c4364213e2\",\n                            \"Width\": 1280,\n                            \"Height\": 720\n                        }\n                    ],\n                    \"OmittedDurations\": [],\n                    \"Details\": \"\",\n                    \"ErrorCode\": 0,\n                    \"ErrorMsg\": \"\"\n                }\n            }\n        ],\n        \"TotalCount\": 151,\n        \"RequestId\": \"bc309eaa-6d64-11e8-a7fe-5254000b4175\"\n    }\n}",
+        "title": "成功"
+      }
+    ],
     "DescribeRoomList": [
       {
         "document": "",

tccli/services/trtc/v20190722/api.json

@@ -211,21 +211,21 @@
       "status": "online"
     },
     "StartMCUMixTranscode": {
-      "document": "接口说明：启动云端混流，并指定混流画面中各路画面的布局位置。\n\nTRTC 的一个房间中可能会同时存在多路音视频流，您可以通过此 API 接口，通知腾讯云服务端将多路视频画面合成一路，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看。房间销毁后混流自动结束。\n\n您可以通过此接口实现如下目标：\n- 设置最终直播流的画质和音质，包括视频分辨率、视频码率、视频帧率、以及声音质量等。\n- 设置各路画面的位置和布局，您只需要在启动时设置一次，排版引擎会自动完成后续的画面排布。\n- 设置录制文件名，用于二次回放。\n- 设置 CDN 直播流 ID，用于在 CDN 进行直播观看。\n\n目前已经支持了如下几种布局模板：\n- 悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面，如果用户只发送音频，仍然会占用画面位置。\n- 九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小。最多支持16个画面，如果用户只发送音频，仍然会占用画面位置。\n- 屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理。\n- 画中画模板：适用于混合大小两路视频画面和其他用户混音，或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上，可以指定大小画面的用户以及小画面的显示位置，最多支持2个画面。\n- 自定义模板：适用于在混流中指定用户的画面位置，或者预设视频画面位置的场景。当预设位置指定用户时，排版引擎会该用户预留位置；当预设位置未指定用户时，排版引擎会根据进房间顺序自动填充。预设位置填满时，不再混合其他用户的画面和声音。自定义模板启用占位图功能时（LayoutParams中的PlaceHolderMode设置成1），在预设位置的用户没有上行视频时可显示对应的占位图（PlaceImageId）。\n\n注意：\n1、**混流转码为收费功能，调用接口将产生云端混流转码费用，详见[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。**\n2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流，如需切换至MCU混流，请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。\n3、客户端混流和服务端混流不能混用。",
+      "document": "接口说明：启动云端混流，并指定混流画面中各路画面的布局位置。\n\nTRTC 的一个房间中可能会同时存在多路音视频流，您可以通过此 API 接口，通知腾讯云服务端将多路视频画面合成一路，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看。房间销毁后混流自动结束。\n\n您可以通过此接口实现如下目标：\n- 设置最终直播流的画质和音质，包括视频分辨率、视频码率、视频帧率、以及声音质量等。\n- 设置各路画面的位置和布局，您只需要在启动时设置一次，排版引擎会自动完成后续的画面排布。\n- 设置录制文件名，用于二次回放。\n- 设置 CDN 直播流 ID，用于在 CDN 进行直播观看。\n\n目前已经支持了如下几种布局模板：\n- 悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面，如果用户只发送音频，仍然会占用画面位置。\n- 九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小。最多支持16个画面，如果用户只发送音频，仍然会占用画面位置。\n- 屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理。\n- 画中画模板：适用于混合大小两路视频画面和其他用户混音，或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上，可以指定大小画面的用户以及小画面的显示位置，最多支持2个画面。\n- 自定义模板：适用于在混流中指定用户的画面位置，或者预设视频画面位置的场景。当预设位置指定用户时，排版引擎会为该用户预留位置；当预设位置未指定用户时，排版引擎会根据进房间顺序自动填充。预设位置填满时，不再混合其他用户的画面和声音。自定义模板启用占位图功能时（LayoutParams中的PlaceHolderMode设置成1），在预设位置的用户没有上行视频时可显示对应的占位图（PlaceImageId）。\n\n注意：\n1、**混流转码为收费功能，调用接口将产生云端混流转码费用，详见[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。**\n2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流，如需切换至MCU混流，请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。\n3、客户端混流和服务端混流不能混用。",
       "input": "StartMCUMixTranscodeRequest",
       "name": "启动云端混流（旧）",
       "output": "StartMCUMixTranscodeResponse",
       "status": "online"
     },
     "StartMCUMixTranscodeByStrRoomId": {
-      "document": "接口说明：启动云端混流，并指定混流画面中各路画面的布局位置。\n\nTRTC 的一个房间中可能会同时存在多路音视频流，您可以通过此 API 接口，通知腾讯云服务端将多路视频画面合成一路，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看。\n\n您可以通过此接口实现如下目标：\n- 设置最终直播流的画质和音质，包括视频分辨率、视频码率、视频帧率、以及声音质量等。\n- 设置各路画面的位置和布局，您只需要在启动时设置一次，排版引擎会自动完成后续的画面排布。\n- 设置录制文件名，用于二次回放。\n- 设置 CDN 直播流 ID，用于在 CDN 进行直播观看。\n\n目前已经支持了如下几种布局模板：\n- 悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面，如果用户只发送音频，仍然会占用画面位置。\n- 九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小。最多支持16个画面，如果用户只发送音频，仍然会占用画面位置。\n- 屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理。\n- 画中画模板：适用于混合大小两路视频画面和其他用户混音，或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上，可以指定大小画面的用户以及小画面的显示位置。\n- 自定义模板：适用于在混流中指定用户的画面位置，或者预设视频画面位置的场景。当预设位置指定用户时，排版引擎会该用户预留位置；当预设位置未指定用户时，排版引擎会根据进房间顺序自动填充。预设位置填满时，不再混合其他用户的画面和声音。自定义模板启用占位图功能时（LayoutParams中的PlaceHolderMode设置成1），在预设位置的用户没有上行视频时可显示对应的占位图（PlaceImageId）。\n\n注意：\n1、**混流转码为收费功能，调用接口将产生云端混流转码费用，详见[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。**\n2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流，如需切换至MCU混流，请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。\n3、客户端混流和服务端混流不能混用。",
+      "document": "接口说明：启动云端混流，并指定混流画面中各路画面的布局位置。\n\nTRTC 的一个房间中可能会同时存在多路音视频流，您可以通过此 API 接口，通知腾讯云服务端将多路视频画面合成一路，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看。\n\n您可以通过此接口实现如下目标：\n- 设置最终直播流的画质和音质，包括视频分辨率、视频码率、视频帧率、以及声音质量等。\n- 设置各路画面的位置和布局，您只需要在启动时设置一次，排版引擎会自动完成后续的画面排布。\n- 设置录制文件名，用于二次回放。\n- 设置 CDN 直播流 ID，用于在 CDN 进行直播观看。\n\n目前已经支持了如下几种布局模板：\n- 悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面，如果用户只发送音频，仍然会占用画面位置。\n- 九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小。最多支持16个画面，如果用户只发送音频，仍然会占用画面位置。\n- 屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理。\n- 画中画模板：适用于混合大小两路视频画面和其他用户混音，或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上，可以指定大小画面的用户以及小画面的显示位置。\n- 自定义模板：适用于在混流中指定用户的画面位置，或者预设视频画面位置的场景。当预设位置指定用户时，排版引擎会为该用户预留位置；当预设位置未指定用户时，排版引擎会根据进房间顺序自动填充。预设位置填满时，不再混合其他用户的画面和声音。自定义模板启用占位图功能时（LayoutParams中的PlaceHolderMode设置成1），在预设位置的用户没有上行视频时可显示对应的占位图（PlaceImageId）。\n\n注意：\n1、**混流转码为收费功能，调用接口将产生云端混流转码费用，详见[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。**\n2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流，如需切换至MCU混流，请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。\n3、客户端混流和服务端混流不能混用。",
       "input": "StartMCUMixTranscodeByStrRoomIdRequest",
-      "name": "启动云端混流（字符串房间号）",
+      "name": "启动云端混流（字符串房间号）（旧）",
       "output": "StartMCUMixTranscodeByStrRoomIdResponse",
       "status": "online"
     },
     "StartPublishCdnStream": {
-      "document": "接口说明：启动旁路以及混流转推任务。TRTC 的房间中可能会同时存在多路音视频流，您可以通过此API接口，实现以下几种效果：\n1、支持将单个主播的音视频流发布（也称作“转推”）到直播CDN上，请参考示例2（发起单流音视频旁路转推）和示例3（发起单流纯音频旁路转推）。\n2、支持将同个房间多个主播或者不同房间多个主播的音视频混合成1路后再发布到直播CDN上，您可以通过AudioParams.SubscribeAudioList和VideoParams.LayoutParams调整参与混音的用户列表以及指定各路混流画面的布局位置。请参考示例1（发起混流转推）。\n3、支持预先设置一个房间的混流模板，将该房间中的多个音视频混合成1路发布到直播CDN，腾讯云后台实时监控TRTC房间中的主播变化，自动按照混流模板调整布局。目前已经支持了如下几种混流预设模板：\n     - 悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面。\n     - 九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小，最多支持16个画面。\n     - 屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理。\n4、支持同时将音视频流发布到最多10个直播CDN上。您可以通过PublishCdnParams.PublishCdnUrl指定转推CDN的url，如果您想转推到腾讯云CDN，PublishCdnParams.IsTencentCdn填为1。\n5、支持通过配置服务端回调，实时将转推状态以HTTP/HTTPS POST 请求发送给您的服务器，如果您需要接入转推事件回调，请联系腾讯云技术支持。\n6、云API调用支持广州、上海、北京、香港四个地域，如果您想转推海外，请选择香港地域。\n7、国内站默认只支持转推腾讯云CDN，如您有转推第三方CDN的需求，请联系腾讯云技术支持，由后台进行评估。\n注意：\n1、**混流转码为收费功能，调用接口将产生云端混流转码费用，详见[云端混流转推计费说明](https://cloud.tencent.com/document/product/647/49446)。**\n2、**转推非腾讯云CDN将产生云端转推费用，详见[云端混流转推计费说明](https://cloud.tencent.com/document/product/647/82155)。**\n\n其他使用说明如下：\n1、使用混流转推接口时，您需要先调用启动转推任务接口（StartPublishCdnStream），获取启动转推任务响应中的任务ID标识（TaskId）。后续传入任务ID标识（TaskId）来更新转推任务（UpdatePublishCdnStream）和停止转推任务（StopPublishCdnStream）。\n2、为了确保转推链接的稳定，同一个转推任务不支持纯音频、音视频、纯视频之间的切换。\n3、为了确保转推链接的稳定，更新转推任务接口（UpdatePublishCdnStream）不支持时更改视频参数（codec）和音频参数（codec、采样率、码率、声道数），其余参数建议全量带齐，如您有转码/非转码切换，其余参数则必须全量带齐。\n4、发起单流旁路任务时，AudioParams和VideoParams都填写表示音视频旁路，如果仅填写AudioParams表示纯音频旁路，任务进行过程中不支持纯音频到音视频的切换。音视频旁路时，VideoParams中的Width、Height、Fps、BitRate、Gop需要按照真实上行参数填写。\n5、更新转推任务（UpdatePublishCdnStream）必须携带SequenceNumber参数，用于防止请求乱序。客户保证对同一个任务更新时的SequenceNumber参数递增：腾讯云返回InternalError错误码时，需重试请求（不换SequenceNumber）；腾讯云返回FailedOperation.OutdateRequest过期错误码时，无需处理即可。\n6、您可以在主播进房前，提前创建转推任务，结束转推任务时需要主动调用停止接口。如果您没有调用停止转推任务接口时，腾讯云后台会按照所有参与混流的用户没有任何数据上行的时间算起，直到超过启动转推任务时设置的超时时间（AgentParams.MaxIdleTime）为止，自动停止混流转推任务。",
+      "document": "接口说明：启动旁路以及混流转推任务。TRTC 的房间中可能会同时存在多路音视频流，您可以通过此API接口，实现以下几种效果：\n1、支持将单个主播的音视频流发布（也称作“转推”）到直播CDN上，请参考示例2（发起单流音视频旁路转推）和示例3（发起单流纯音频旁路转推）。\n2、支持将同个房间多个主播或者不同房间多个主播的音视频混合成1路后再发布到直播CDN上，您可以通过AudioParams.SubscribeAudioList和VideoParams.LayoutParams调整参与混音的用户列表以及指定各路混流画面的布局位置。请参考示例1（发起混流转推）。\n3、支持预先设置一个房间的混流模板，将该房间中的多个音视频混合成1路发布到直播CDN，腾讯云后台实时监控TRTC房间中的主播变化，自动按照混流模板调整布局。目前已经支持了如下几种混流预设模板：\n     - 悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面。\n     - 九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小，最多支持16个画面。\n     - 屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理。\n4、支持同时将音视频流发布到最多10个直播CDN上。您可以通过PublishCdnParams.PublishCdnUrl指定转推CDN的url，如果您想转推到腾讯云CDN，PublishCdnParams.IsTencentCdn填为1。\n5、支持通过配置服务端回调，实时将转推状态以HTTP/HTTPS POST 请求发送给您的服务器，如果您需要接入转推事件回调，请联系腾讯云技术支持。\n6、云API调用支持广州、上海、北京、香港四个地域，如果您想转推海外，请选择香港地域。\n7、国内站默认只支持转推腾讯云CDN，如您有转推第三方CDN的需求，请联系腾讯云技术支持，由后台进行评估。\n注意：\n1、**混流转码为收费功能，调用接口将产生云端混流转码费用，详见[云端混流转推计费说明](https://cloud.tencent.com/document/product/647/49446)。**\n2、**转推非腾讯云CDN将产生云端转推费用，详见[云端混流转推计费说明](https://cloud.tencent.com/document/product/647/82155)。**\n\n其他使用说明如下：\n1、使用混流转推接口时，您需要先调用启动转推任务接口（StartPublishCdnStream），获取启动转推任务响应中的任务ID标识（TaskId）。后续传入任务ID标识（TaskId）来更新转推任务（UpdatePublishCdnStream）和停止转推任务（StopPublishCdnStream）。\n2、为了确保转推链接的稳定，同一个转推任务不支持纯音频、音视频、纯视频之间的切换。\n3、为了确保转推链接的稳定，更新转推任务接口（UpdatePublishCdnStream）时不支持更改视频参数（codec）和音频参数（codec、采样率、码率、声道数），其余参数建议全量带齐，如您有转码/非转码切换，其余参数则必须全量带齐。\n4、发起单流旁路任务时，AudioParams和VideoParams都填写表示音视频旁路，如果仅填写AudioParams表示纯音频旁路，任务进行过程中不支持纯音频到音视频的切换。音视频旁路时，VideoParams中的Width、Height、Fps、BitRate、Gop需要按照真实上行参数填写。\n5、更新转推任务（UpdatePublishCdnStream）必须携带SequenceNumber参数，用于防止请求乱序。客户保证对同一个任务更新时的SequenceNumber参数递增：腾讯云返回InternalError错误码时，需重试请求（不换SequenceNumber）；腾讯云返回FailedOperation.OutdateRequest过期错误码时，无需处理即可。\n6、您可以在主播进房前，提前创建转推任务，结束转推任务时需要主动调用停止接口。如果您没有调用停止转推任务接口时，腾讯云后台会按照所有参与混流的用户没有任何数据上行的时间算起，直到超过启动转推任务时设置的超时时间（AgentParams.MaxIdleTime）为止，自动停止混流转推任务。",
       "input": "StartPublishCdnStreamRequest",
       "name": "启动转推任务",
       "output": "StartPublishCdnStreamResponse",
@@ -2591,7 +2591,7 @@
           "value_allowed_null": false
         },
         {
-          "document": "屏幕分享模板、悬浮模板、九宫格模板、画中画模版有效，画面在输出时的显示模式：0为裁剪，1为缩放，2为缩放并显示黑底，不填采用后台的默认渲染方式（屏幕分享大画面为缩放，其他为裁剪）。",
+          "document": "屏幕分享模板、悬浮模板、九宫格模板、画中画模版有效，画面在输出时的显示模式：0为裁剪，1为缩放，2为缩放并显示黑底，不填采用后台的默认渲染方式（屏幕分享大画面为缩放，其他为裁剪）。若此参数不生效，请请提交工单寻求帮助。",
           "example": "0",
           "member": "uint64",
           "name": "RenderMode",
@@ -4575,7 +4575,6 @@
       "document": "StartMCUMixTranscodeByStrRoomId请求参数结构体",
       "members": [
         {
-          "default": "",
           "document": "TRTC的SDKAppId。",
           "example": "1400188366",
           "member": "uint64",
@@ -4584,7 +4583,6 @@
           "type": "int"
         },
         {
-          "default": "",
           "document": "字符串房间号。",
           "example": "3560",
           "member": "string",
@@ -4593,7 +4591,6 @@
           "type": "string"
         },
         {
-          "default": "",
           "document": "混流输出控制参数。",
           "example": "OutputParams",
           "member": "OutputParams",
@@ -4602,7 +4599,6 @@
           "type": "object"
         },
         {
-          "default": "",
           "document": "混流输出编码参数。",
           "example": "EncodeParams",
           "member": "EncodeParams",
@@ -4611,7 +4607,6 @@
           "type": "object"
         },
         {
-          "default": "",
           "document": "混流输出布局参数。",
           "example": "LayoutParams",
           "member": "LayoutParams",
@@ -4620,7 +4615,6 @@
           "type": "object"
         },
         {
-          "default": "",
           "document": "第三方CDN转推参数。",
           "example": "PublishCdnParams",
           "member": "PublishCdnParams",
@@ -4647,7 +4641,6 @@
       "document": "StartMCUMixTranscode请求参数结构体",
       "members": [
         {
-          "default": "",
           "document": "TRTC的SDKAppId。",
           "example": "1400188366",
           "member": "uint64",
@@ -4656,7 +4649,6 @@
           "type": "int"
         },
         {
-          "default": "",
           "document": "房间号。",
           "example": "3560",
           "member": "uint64",
@@ -4665,7 +4657,6 @@
           "type": "int"
         },
         {
-          "default": "",
           "document": "混流输出控制参数。",
           "example": "OutputParams",
           "member": "OutputParams",
@@ -4674,7 +4665,6 @@
           "type": "object"
         },
         {
-          "default": "",
           "document": "混流输出编码参数。",
           "example": "EncodeParams",
           "member": "EncodeParams",
@@ -4683,7 +4673,6 @@
           "type": "object"
         },
         {
-          "default": "",
           "document": "混流输出布局参数。",
           "example": "LayoutParams",
           "member": "LayoutParams",
@@ -4692,7 +4681,6 @@
           "type": "object"
         },
         {
-          "default": "",
           "document": "第三方CDN转推参数。",
           "example": "PublishCdnParams",
           "member": "PublishCdnParams",