tencentcloud-sdk-nodejs 4.0.907 → 4.0.909

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/CHANGELOG.md +420 -0
  2. package/SERVICE_CHANGELOG.md +662 -30
  3. package/package.json +1 -1
  4. package/products.md +32 -32
  5. package/src/common/sdk_version.ts +1 -1
  6. package/src/services/aiart/v20221229/aiart_client.ts +3 -1
  7. package/src/services/aiart/v20221229/aiart_models.ts +5 -5
  8. package/src/services/apm/v20210622/apm_models.ts +4 -0
  9. package/src/services/cbs/v20170312/cbs_models.ts +1 -1
  10. package/src/services/cdb/v20170320/cdb_models.ts +31 -7
  11. package/src/services/cdwdoris/v20211228/cdwdoris_client.ts +616 -96
  12. package/src/services/cdwdoris/v20211228/cdwdoris_models.ts +3241 -797
  13. package/src/services/cfs/v20190719/cfs_client.ts +2 -2
  14. package/src/services/cfs/v20190719/cfs_models.ts +14 -6
  15. package/src/services/csip/v20221121/csip_models.ts +8 -0
  16. package/src/services/dlc/v20210125/dlc_client.ts +1 -1
  17. package/src/services/dlc/v20210125/dlc_models.ts +13 -1
  18. package/src/services/domain/v20180808/domain_models.ts +1 -1
  19. package/src/services/emr/v20190103/emr_models.ts +9 -1
  20. package/src/services/ess/v20201111/ess_client.ts +46 -10
  21. package/src/services/ess/v20201111/ess_models.ts +7 -7
  22. package/src/services/essbasic/v20210526/essbasic_client.ts +15 -3
  23. package/src/services/essbasic/v20210526/essbasic_models.ts +9 -7
  24. package/src/services/faceid/v20180301/faceid_models.ts +1 -1
  25. package/src/services/hunyuan/v20230901/hunyuan_models.ts +9 -1
  26. package/src/services/iotexplorer/v20190423/iotexplorer_client.ts +300 -276
  27. package/src/services/iotexplorer/v20190423/iotexplorer_models.ts +3804 -3686
  28. package/src/services/lcic/v20220817/lcic_models.ts +8 -0
  29. package/src/services/lke/v20231130/lke_client.ts +12 -4
  30. package/src/services/lke/v20231130/lke_models.ts +376 -95
  31. package/src/services/monitor/v20180724/monitor_models.ts +5 -5
  32. package/src/services/mps/v20190612/mps_models.ts +11 -0
  33. package/src/services/organization/v20210331/organization_client.ts +13 -0
  34. package/src/services/organization/v20210331/organization_models.ts +110 -0
  35. package/src/services/rce/v20201103/rce_client.ts +142 -9
  36. package/src/services/rce/v20201103/rce_models.ts +1027 -216
  37. package/src/services/redis/v20180412/redis_client.ts +34 -8
  38. package/src/services/redis/v20180412/redis_models.ts +192 -9
  39. package/src/services/tmt/v20180321/tmt_models.ts +1 -1
  40. package/src/services/trro/v20220325/trro_client.ts +1 -0
  41. package/src/services/trro/v20220325/trro_models.ts +96 -5
  42. package/src/services/trtc/v20190722/trtc_client.ts +14 -100
  43. package/src/services/trtc/v20190722/trtc_models.ts +6 -1
  44. package/src/services/tse/v20201207/tse_models.ts +5 -0
  45. package/src/services/tsf/v20180326/tsf_models.ts +4 -4
  46. package/src/services/tsi/v20210325/tsi_client.ts +13 -2
  47. package/src/services/tsi/v20210325/tsi_models.ts +24 -4
  48. package/tencentcloud/common/sdk_version.d.ts +1 -1
  49. package/tencentcloud/common/sdk_version.js +1 -1
  50. package/tencentcloud/services/aiart/v20221229/aiart_client.d.ts +3 -1
  51. package/tencentcloud/services/aiart/v20221229/aiart_client.js +3 -1
  52. package/tencentcloud/services/aiart/v20221229/aiart_models.d.ts +5 -5
  53. package/tencentcloud/services/apm/v20210622/apm_models.d.ts +4 -0
  54. package/tencentcloud/services/cbs/v20170312/cbs_models.d.ts +1 -1
  55. package/tencentcloud/services/cdb/v20170320/cdb_models.d.ts +31 -7
  56. package/tencentcloud/services/cdwdoris/v20211228/cdwdoris_client.d.ts +187 -23
  57. package/tencentcloud/services/cdwdoris/v20211228/cdwdoris_client.js +279 -33
  58. package/tencentcloud/services/cdwdoris/v20211228/cdwdoris_models.d.ts +3130 -796
  59. package/tencentcloud/services/cfs/v20190719/cfs_client.d.ts +2 -2
  60. package/tencentcloud/services/cfs/v20190719/cfs_client.js +2 -2
  61. package/tencentcloud/services/cfs/v20190719/cfs_models.d.ts +14 -6
  62. package/tencentcloud/services/csip/v20221121/csip_models.d.ts +8 -0
  63. package/tencentcloud/services/dlc/v20210125/dlc_client.d.ts +1 -1
  64. package/tencentcloud/services/dlc/v20210125/dlc_client.js +1 -1
  65. package/tencentcloud/services/dlc/v20210125/dlc_models.d.ts +13 -1
  66. package/tencentcloud/services/domain/v20180808/domain_models.d.ts +1 -1
  67. package/tencentcloud/services/emr/v20190103/emr_models.d.ts +9 -1
  68. package/tencentcloud/services/ess/v20201111/ess_client.d.ts +44 -8
  69. package/tencentcloud/services/ess/v20201111/ess_client.js +44 -8
  70. package/tencentcloud/services/ess/v20201111/ess_models.d.ts +7 -7
  71. package/tencentcloud/services/essbasic/v20210526/essbasic_client.d.ts +13 -1
  72. package/tencentcloud/services/essbasic/v20210526/essbasic_client.js +13 -1
  73. package/tencentcloud/services/essbasic/v20210526/essbasic_models.d.ts +9 -7
  74. package/tencentcloud/services/faceid/v20180301/faceid_models.d.ts +1 -1
  75. package/tencentcloud/services/hunyuan/v20230901/hunyuan_models.d.ts +9 -1
  76. package/tencentcloud/services/iotexplorer/v20190423/iotexplorer_client.d.ts +11 -3
  77. package/tencentcloud/services/iotexplorer/v20190423/iotexplorer_client.js +15 -3
  78. package/tencentcloud/services/iotexplorer/v20190423/iotexplorer_models.d.ts +3732 -3618
  79. package/tencentcloud/services/lcic/v20220817/lcic_models.d.ts +8 -0
  80. package/tencentcloud/services/lke/v20231130/lke_client.d.ts +1 -1
  81. package/tencentcloud/services/lke/v20231130/lke_models.d.ts +368 -95
  82. package/tencentcloud/services/monitor/v20180724/monitor_models.d.ts +5 -5
  83. package/tencentcloud/services/mps/v20190612/mps_models.d.ts +11 -0
  84. package/tencentcloud/services/organization/v20210331/organization_client.d.ts +5 -1
  85. package/tencentcloud/services/organization/v20210331/organization_client.js +6 -0
  86. package/tencentcloud/services/organization/v20210331/organization_models.d.ts +107 -0
  87. package/tencentcloud/services/rce/v20201103/rce_client.d.ts +37 -1
  88. package/tencentcloud/services/rce/v20201103/rce_client.js +54 -0
  89. package/tencentcloud/services/rce/v20201103/rce_models.d.ts +983 -215
  90. package/tencentcloud/services/redis/v20180412/redis_client.d.ts +11 -3
  91. package/tencentcloud/services/redis/v20180412/redis_client.js +15 -3
  92. package/tencentcloud/services/redis/v20180412/redis_models.d.ts +186 -9
  93. package/tencentcloud/services/tmt/v20180321/tmt_models.d.ts +1 -1
  94. package/tencentcloud/services/trro/v20220325/trro_models.d.ts +95 -5
  95. package/tencentcloud/services/trtc/v20190722/trtc_client.d.ts +12 -98
  96. package/tencentcloud/services/trtc/v20190722/trtc_client.js +12 -98
  97. package/tencentcloud/services/trtc/v20190722/trtc_models.d.ts +6 -1
  98. package/tencentcloud/services/tse/v20201207/tse_models.d.ts +5 -0
  99. package/tencentcloud/services/tsf/v20180326/tsf_models.d.ts +4 -4
  100. package/tencentcloud/services/tsi/v20210325/tsi_client.d.ts +12 -1
  101. package/tencentcloud/services/tsi/v20210325/tsi_client.js +12 -1
  102. package/tencentcloud/services/tsi/v20210325/tsi_models.d.ts +24 -4
  103. package/test/cdwdoris.v20211228.test.js +432 -22
  104. package/test/iotexplorer.v20190423.test.js +22 -2
  105. package/test/organization.v20210331.test.js +10 -0
  106. package/test/rce.v20201103.test.js +90 -0
  107. package/test/redis.v20180412.test.js +22 -2
@@ -25,6 +25,7 @@ import {
25
25
  ModifyInstanceAvailabilityZonesRequest,
26
26
  RedisBackupSet,
27
27
  DescribeInstanceMonitorTopNCmdResponse,
28
+ ModifyInstanceAvailabilityZonesResponse,
28
29
  ModifyAutoBackupConfigResponse,
29
30
  RestoreInstanceRequest,
30
31
  AllocateWanAddressRequest,
@@ -80,6 +81,7 @@ import {
80
81
  DescribeInstanceShardsResponse,
81
82
  DestroyPrepaidInstanceRequest,
82
83
  DisableReplicaReadonlyRequest,
84
+ CDCResource,
83
85
  TaskInfoDetail,
84
86
  ModifyBackupDownloadRestrictionRequest,
85
87
  DisableReplicaReadonlyResponse,
@@ -128,6 +130,7 @@ import {
128
130
  AllocateWanAddressResponse,
129
131
  DescribeInstanceMonitorTookDistRequest,
130
132
  DeleteReplicationInstanceRequest,
133
+ SwitchAccessNewInstanceRequest,
131
134
  KillMasterGroupRequest,
132
135
  SwitchAccessNewInstanceResponse,
133
136
  CloneInstancesResponse,
@@ -137,6 +140,7 @@ import {
137
140
  DescribeInstanceMonitorBigKeySizeDistRequest,
138
141
  DescribeInstanceAccountRequest,
139
142
  InstanceTextParam,
143
+ DescribeRedisClusterOverviewResponse,
140
144
  DescribeInstanceParamRecordsRequest,
141
145
  DescribeTaskListRequest,
142
146
  ChangeMasterInstanceResponse,
@@ -205,7 +209,7 @@ import {
205
209
  DescribeInstanceMonitorHotKeyRequest,
206
210
  DescribeBackupDownloadRestrictionResponse,
207
211
  UpgradeInstanceResponse,
208
- SwitchAccessNewInstanceRequest,
212
+ ResourceBundle,
209
213
  ManualBackupInstanceRequest,
210
214
  DescribeReplicationGroupResponse,
211
215
  ModifyParamTemplateRequest,
@@ -219,8 +223,10 @@ import {
219
223
  DescribeInstanceMonitorBigKeyTypeDistRequest,
220
224
  DescribeInstanceMonitorTopNCmdTookRequest,
221
225
  DestroyPrepaidInstanceResponse,
226
+ DescribeRedisClusterOverviewRequest,
222
227
  DescribeCommonDBInstancesResponse,
223
228
  InquiryPriceCreateInstanceRequest,
229
+ DescribeRedisClustersRequest,
224
230
  UpgradeSmallVersionResponse,
225
231
  ModifyInstanceParamsRequest,
226
232
  DescribeSSLStatusRequest,
@@ -235,7 +241,7 @@ import {
235
241
  DescribeSSLStatusResponse,
236
242
  DescribeTendisSlowLogRequest,
237
243
  DescribeProxySlowLogRequest,
238
- ModifyInstanceAvailabilityZonesResponse,
244
+ DescribeRedisClustersResponse,
239
245
  DescribeProxySlowLogResponse,
240
246
  ModifyInstanceReadOnlyRequest,
241
247
  DescribeInstanceAccountResponse,
@@ -1014,6 +1020,16 @@ export class Client extends AbstractClient {
1014
1020
  return this.request("DescribeInstanceMonitorBigKey", req, cb)
1015
1021
  }
1016
1022
 
1023
+ /**
1024
+ * 查询Redis独享集群列表
1025
+ */
1026
+ async DescribeRedisClusters(
1027
+ req: DescribeRedisClustersRequest,
1028
+ cb?: (error: string, rep: DescribeRedisClustersResponse) => void
1029
+ ): Promise<DescribeRedisClustersResponse> {
1030
+ return this.request("DescribeRedisClusters", req, cb)
1031
+ }
1032
+
1017
1033
  /**
1018
1034
  * 本接口(KillMasterGroup)模拟故障。
1019
1035
  */
@@ -1084,6 +1100,16 @@ export class Client extends AbstractClient {
1084
1100
  return this.request("SwitchInstanceVip", req, cb)
1085
1101
  }
1086
1102
 
1103
+ /**
1104
+ * 本接口(DescribeDBSecurityGroups)用于查询实例的安全组详情。
1105
+ */
1106
+ async DescribeDBSecurityGroups(
1107
+ req: DescribeDBSecurityGroupsRequest,
1108
+ cb?: (error: string, rep: DescribeDBSecurityGroupsResponse) => void
1109
+ ): Promise<DescribeDBSecurityGroupsResponse> {
1110
+ return this.request("DescribeDBSecurityGroups", req, cb)
1111
+ }
1112
+
1087
1113
  /**
1088
1114
  * 本接口(DescribeReplicationGroup)用于查询复制组。
1089
1115
  */
@@ -1245,13 +1271,13 @@ export class Client extends AbstractClient {
1245
1271
  }
1246
1272
 
1247
1273
  /**
1248
- * 本接口(DescribeDBSecurityGroups)用于查询实例的安全组详情。
1274
+ * 查询Redis独享集群概览信息
1249
1275
  */
1250
- async DescribeDBSecurityGroups(
1251
- req: DescribeDBSecurityGroupsRequest,
1252
- cb?: (error: string, rep: DescribeDBSecurityGroupsResponse) => void
1253
- ): Promise<DescribeDBSecurityGroupsResponse> {
1254
- return this.request("DescribeDBSecurityGroups", req, cb)
1276
+ async DescribeRedisClusterOverview(
1277
+ req: DescribeRedisClusterOverviewRequest,
1278
+ cb?: (error: string, rep: DescribeRedisClusterOverviewResponse) => void
1279
+ ): Promise<DescribeRedisClusterOverviewResponse> {
1280
+ return this.request("DescribeRedisClusterOverview", req, cb)
1255
1281
  }
1256
1282
 
1257
1283
  /**
@@ -204,6 +204,20 @@ export interface DescribeInstanceMonitorTopNCmdResponse {
204
204
  RequestId?: string
205
205
  }
206
206
 
207
+ /**
208
+ * ModifyInstanceAvailabilityZones返回参数结构体
209
+ */
210
+ export interface ModifyInstanceAvailabilityZonesResponse {
211
+ /**
212
+ * 任务ID。
213
+ */
214
+ TaskId?: number
215
+ /**
216
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
217
+ */
218
+ RequestId?: string
219
+ }
220
+
207
221
  /**
208
222
  * ModifyAutoBackupConfig返回参数结构体
209
223
  */
@@ -1554,6 +1568,68 @@ export interface DisableReplicaReadonlyRequest {
1554
1568
  InstanceId: string
1555
1569
  }
1556
1570
 
1571
+ /**
1572
+ * redis独享集群详细信息
1573
+ */
1574
+ export interface CDCResource {
1575
+ /**
1576
+ * 用户的Appid
1577
+ */
1578
+ AppId: number
1579
+ /**
1580
+ * 地域id
1581
+ */
1582
+ RegionId: number
1583
+ /**
1584
+ * 可用区id
1585
+ */
1586
+ ZoneId: number
1587
+ /**
1588
+ * redis独享集群id
1589
+ */
1590
+ RedisClusterId: string
1591
+ /**
1592
+ * 计费模式,1-包年包月,0-按量计费
1593
+ */
1594
+ PayMode: number
1595
+ /**
1596
+ * 项目id
1597
+ */
1598
+ ProjectId: number
1599
+ /**
1600
+ * 自动续费标识,0 - 默认状态(手动续费);1 - 自动续费;2 - 明确不自动续费
1601
+ */
1602
+ AutoRenewFlag: number
1603
+ /**
1604
+ * 独享集群名称
1605
+ */
1606
+ ClusterName: string
1607
+ /**
1608
+ * 实例创建时间
1609
+ */
1610
+ StartTime: string
1611
+ /**
1612
+ * 实例到期时间
1613
+ */
1614
+ EndTime: string
1615
+ /**
1616
+ * 集群状态:1-流程中,2-运行中,3-已隔离
1617
+ */
1618
+ Status: number
1619
+ /**
1620
+ * 基础管控资源包
1621
+ */
1622
+ BaseBundles: Array<ResourceBundle>
1623
+ /**
1624
+ * 资源包列表
1625
+ */
1626
+ ResourceBundles: Array<ResourceBundle>
1627
+ /**
1628
+ * 所属本地专有集群id
1629
+ */
1630
+ DedicatedClusterId: string
1631
+ }
1632
+
1557
1633
  /**
1558
1634
  * 任务信息详情
1559
1635
  */
@@ -2635,6 +2711,17 @@ export interface DeleteReplicationInstanceRequest {
2635
2711
  SyncType: boolean
2636
2712
  }
2637
2713
 
2714
+ /**
2715
+ * SwitchAccessNewInstance请求参数结构体
2716
+ */
2717
+ export interface SwitchAccessNewInstanceRequest {
2718
+ /**
2719
+ * 指定实例 ID。例如:crs-xjhsdj****。请登录[Redis控制台](https://console.cloud.tencent.com/redis#/)在实例列表复制实例 ID。
2720
+ 示例值:crs-asdasdas
2721
+ */
2722
+ InstanceId: string
2723
+ }
2724
+
2638
2725
  /**
2639
2726
  * KillMasterGroup请求参数结构体
2640
2727
  */
@@ -2814,6 +2901,24 @@ export interface InstanceTextParam {
2814
2901
  Status?: number
2815
2902
  }
2816
2903
 
2904
+ /**
2905
+ * DescribeRedisClusterOverview返回参数结构体
2906
+ */
2907
+ export interface DescribeRedisClusterOverviewResponse {
2908
+ /**
2909
+ * 资源包总数
2910
+ */
2911
+ TotalBundle: number
2912
+ /**
2913
+ * 资源包总内存大小,单位:GB
2914
+ */
2915
+ TotalMemory: number
2916
+ /**
2917
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2918
+ */
2919
+ RequestId?: string
2920
+ }
2921
+
2817
2922
  /**
2818
2923
  * DescribeInstanceParamRecords请求参数结构体
2819
2924
  */
@@ -4606,14 +4711,21 @@ export interface UpgradeInstanceResponse {
4606
4711
  }
4607
4712
 
4608
4713
  /**
4609
- * SwitchAccessNewInstance请求参数结构体
4714
+ * redis独享集群资源包
4610
4715
  */
4611
- export interface SwitchAccessNewInstanceRequest {
4716
+ export interface ResourceBundle {
4612
4717
  /**
4613
- * 指定实例 ID。例如:crs-xjhsdj****。请登录[Redis控制台](https://console.cloud.tencent.com/redis#/)在实例列表复制实例 ID。
4614
- 示例值:crs-asdasdas
4718
+ * 资源包名称
4615
4719
  */
4616
- InstanceId: string
4720
+ ResourceBundleName: string
4721
+ /**
4722
+ * 可售卖内存,单位:GB
4723
+ */
4724
+ AvailableMemory: number
4725
+ /**
4726
+ * 资源包个数
4727
+ */
4728
+ Count: number
4617
4729
  }
4618
4730
 
4619
4731
  /**
@@ -4937,6 +5049,21 @@ export interface InstanceSet {
4937
5049
  注意:此字段可能返回 null,表示取不到有效值。
4938
5050
  */
4939
5051
  PolarisServer?: string
5052
+ /**
5053
+ * CDC Redis集群ID。
5054
+ 注意:此字段可能返回 null,表示取不到有效值。
5055
+ */
5056
+ RedisClusterId?: string
5057
+ /**
5058
+ * CDC 集群ID。
5059
+ 注意:此字段可能返回 null,表示取不到有效值。
5060
+ */
5061
+ DedicatedClusterId?: string
5062
+ /**
5063
+ * 产品版本。<ul><li>local:本地盘。</li><li>cloud:云盘版。</li><li>cdc:CDC 集群版本。</li></ul>
5064
+ 注意:此字段可能返回 null,表示取不到有效值。
5065
+ */
5066
+ ProductVersion?: string
4940
5067
  /**
4941
5068
  * 实例当前Proxy版本。
4942
5069
  注意:此字段可能返回 null,表示取不到有效值。
@@ -5076,6 +5203,16 @@ export interface DestroyPrepaidInstanceResponse {
5076
5203
  RequestId?: string
5077
5204
  }
5078
5205
 
5206
+ /**
5207
+ * DescribeRedisClusterOverview请求参数结构体
5208
+ */
5209
+ export interface DescribeRedisClusterOverviewRequest {
5210
+ /**
5211
+ * 本地专用集群id
5212
+ */
5213
+ DedicatedClusterId?: string
5214
+ }
5215
+
5079
5216
  /**
5080
5217
  * DescribeCommonDBInstances返回参数结构体
5081
5218
  */
@@ -5163,6 +5300,48 @@ Redis2.8标准架构、CKV标准架构无需填写。
5163
5300
  ProductVersion?: string
5164
5301
  }
5165
5302
 
5303
+ /**
5304
+ * DescribeRedisClusters请求参数结构体
5305
+ */
5306
+ export interface DescribeRedisClustersRequest {
5307
+ /**
5308
+ * Redis独享集群id
5309
+ */
5310
+ RedisClusterIds?: Array<string>
5311
+ /**
5312
+ * 集群状态:1-流程中,2-运行中,3-已隔离
5313
+ */
5314
+ Status?: Array<number | bigint>
5315
+ /**
5316
+ * 项目ID数组
5317
+ */
5318
+ ProjectIds?: Array<number | bigint>
5319
+ /**
5320
+ * 续费模式:0 - 默认状态(手动续费);1 - 自动续费;2 - 明确不自动续费
5321
+ */
5322
+ AutoRenewFlag?: Array<number | bigint>
5323
+ /**
5324
+ * Redis独享集群名称
5325
+ */
5326
+ ClusterName?: string
5327
+ /**
5328
+ * 搜索关键词:支持集群Id、集群名称
5329
+ */
5330
+ SearchKey?: string
5331
+ /**
5332
+ * 分页限制返回大小,不传则默认为20
5333
+ */
5334
+ Limit?: number
5335
+ /**
5336
+ * 偏移量,取Limit整数倍
5337
+ */
5338
+ Offset?: number
5339
+ /**
5340
+ * 本地专用集群id
5341
+ */
5342
+ DedicatedClusterId?: string
5343
+ }
5344
+
5166
5345
  /**
5167
5346
  * UpgradeSmallVersion返回参数结构体
5168
5347
  */
@@ -5478,13 +5657,17 @@ export interface DescribeProxySlowLogRequest {
5478
5657
  }
5479
5658
 
5480
5659
  /**
5481
- * ModifyInstanceAvailabilityZones返回参数结构体
5660
+ * DescribeRedisClusters返回参数结构体
5482
5661
  */
5483
- export interface ModifyInstanceAvailabilityZonesResponse {
5662
+ export interface DescribeRedisClustersResponse {
5484
5663
  /**
5485
- * 任务ID。
5664
+ * 集群总数
5486
5665
  */
5487
- TaskId?: number
5666
+ Total: number
5667
+ /**
5668
+ * CDC集群资源列表
5669
+ */
5670
+ Resources: Array<CDCResource>
5488
5671
  /**
5489
5672
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
5490
5673
  */
@@ -50,7 +50,7 @@ export interface ImageTranslateRequest {
50
50
  */
51
51
  Scene: string
52
52
  /**
53
- * 图片数据的Base64字符串,图片大小上限为4M,建议对源图片进行一定程度压缩
53
+ * 图片数据的Base64字符串,经Base64编码后不超过 7M,分辨率建议600*800以上,支持PNG、JPG、JPEG、BMP、PDF格式。图片中包含文字需要少于6000字符。
54
54
  */
55
55
  Data: string
56
56
  /**
@@ -59,6 +59,7 @@ import {
59
59
  SessionDeviceDetail,
60
60
  GetDeviceLicenseResponse,
61
61
  CreateDeviceResponse,
62
+ MultiNet,
62
63
  DescribeSessionStatisticsByIntervalRequest,
63
64
  CreateDeviceRequest,
64
65
  DescribeSessionStatisticsResponse,
@@ -22,7 +22,7 @@ export interface DescribeDeviceSessionDetailsResponse {
22
22
  /**
23
23
  * 按设备区分的会话详细数据
24
24
  */
25
- Details: Array<SessionDeviceDetail>
25
+ Details?: Array<SessionDeviceDetail>
26
26
  /**
27
27
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
28
28
  */
@@ -754,15 +754,15 @@ export interface DescribeDeviceListResponse {
754
754
  /**
755
755
  * 设备信息列表
756
756
  */
757
- Devices: Array<DeviceInfo>
757
+ Devices?: Array<DeviceInfo>
758
758
  /**
759
759
  * 设备总数
760
760
  */
761
- Total: number
761
+ Total?: number
762
762
  /**
763
763
  * 本次返回的设备数
764
764
  */
765
- Num: number
765
+ Num?: number
766
766
  /**
767
767
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
768
768
  */
@@ -821,6 +821,10 @@ export interface DescribeDeviceListRequest {
821
821
  * 当前页码,不填默认为1(首页)
822
822
  */
823
823
  PageNumber?: number
824
+ /**
825
+ * 设备状态筛选,不填默认为不过滤。取值:["ready","connected","online"],online代表ready或connected
826
+ */
827
+ DeviceStatus?: string
824
828
  }
825
829
 
826
830
  /**
@@ -899,8 +903,9 @@ export interface SessionDeviceDetail {
899
903
  */
900
904
  DecodeCost?: Array<number | bigint>
901
905
  /**
902
- * 渲染耗时,单位:ms
906
+ * 【已废弃,使用RenderCost】
903
907
  注意:此字段可能返回 null,表示取不到有效值。
908
+ * @deprecated
904
909
  */
905
910
  RenderConst?: Array<number | bigint>
906
911
  /**
@@ -943,6 +948,56 @@ export interface SessionDeviceDetail {
943
948
  注意:此字段可能返回 null,表示取不到有效值。
944
949
  */
945
950
  CaptureCost?: Array<number | bigint>
951
+ /**
952
+ * 渲染耗时,单位:ms
953
+ 注意:此字段可能返回 null,表示取不到有效值。
954
+ */
955
+ RenderCost?: Array<number | bigint>
956
+ /**
957
+ * 配置宽度
958
+ 注意:此字段可能返回 null,表示取不到有效值。
959
+ */
960
+ ConfigWidth?: number
961
+ /**
962
+ * 配置高度
963
+ 注意:此字段可能返回 null,表示取不到有效值。
964
+ */
965
+ ConfigHeight?: number
966
+ /**
967
+ * 平均帧间隔
968
+ 注意:此字段可能返回 null,表示取不到有效值。
969
+ */
970
+ FrameDelta?: Array<number | bigint>
971
+ /**
972
+ * 最大帧间隔
973
+ 注意:此字段可能返回 null,表示取不到有效值。
974
+ */
975
+ MaxFrameDelta?: Array<number | bigint>
976
+ /**
977
+ * 总码率评估,单位:kbps
978
+ 注意:此字段可能返回 null,表示取不到有效值。
979
+ */
980
+ TotalBitrateEstimate?: Array<number | bigint>
981
+ /**
982
+ * 帧间隔大于100ms的卡顿时长
983
+ 注意:此字段可能返回 null,表示取不到有效值。
984
+ */
985
+ Lag100Duration?: Array<number | bigint>
986
+ /**
987
+ * 帧间隔大于150ms的卡顿时长
988
+ 注意:此字段可能返回 null,表示取不到有效值。
989
+ */
990
+ Lag150Duration?: Array<number | bigint>
991
+ /**
992
+ * 是否开启多网:0 单网,1 多网
993
+ 注意:此字段可能返回 null,表示取不到有效值。
994
+ */
995
+ MultiMode?: number
996
+ /**
997
+ * 多网卡信息
998
+ 注意:此字段可能返回 null,表示取不到有效值。
999
+ */
1000
+ MultiNet?: Array<MultiNet>
946
1001
  }
947
1002
 
948
1003
  /**
@@ -969,6 +1024,42 @@ export interface CreateDeviceResponse {
969
1024
  RequestId?: string
970
1025
  }
971
1026
 
1027
+ /**
1028
+ * 多网的网卡状态信息
1029
+ */
1030
+ export interface MultiNet {
1031
+ /**
1032
+ * 网卡序号
1033
+ 注意:此字段可能返回 null,表示取不到有效值。
1034
+ */
1035
+ NetId?: number
1036
+ /**
1037
+ * 网卡IP
1038
+ 注意:此字段可能返回 null,表示取不到有效值。
1039
+ */
1040
+ NetIp?: string
1041
+ /**
1042
+ * 时延,单位ms
1043
+ 注意:此字段可能返回 null,表示取不到有效值。
1044
+ */
1045
+ Rtt?: Array<number | bigint>
1046
+ /**
1047
+ * 丢包率,单位%
1048
+ 注意:此字段可能返回 null,表示取不到有效值。
1049
+ */
1050
+ Lost?: Array<number | bigint>
1051
+ /**
1052
+ * 发送bps,单位kbps
1053
+ 注意:此字段可能返回 null,表示取不到有效值。
1054
+ */
1055
+ SendBps?: Array<number | bigint>
1056
+ /**
1057
+ * 接收bps,单位kbps
1058
+ 注意:此字段可能返回 null,表示取不到有效值。
1059
+ */
1060
+ RecvBps?: Array<number | bigint>
1061
+ }
1062
+
972
1063
  /**
973
1064
  * DescribeSessionStatisticsByInterval请求参数结构体
974
1065
  */
@@ -291,102 +291,14 @@ networkDelay :网络延迟率。
291
291
  }
292
292
 
293
293
  /**
294
- * TRTC房间中可能会同时存在多路音视频流,您可以通过混流转推API,通知腾讯云服务端将同个房间或者多个房间的多路视频画面混合到一起,并指定每一路画面的位置,同时将多路声音进行混音,最终形成一路音视频流,以便用于录制和直播观看,同时可以支持将这一路音视频的混流回推到TRTC房间内部。
295
-
296
- 云api混流转推功能包含三个接口:
297
- 1、StartPublishCdnStream:启动一个混流转推任务,此接口会发起一个新的混流转推任务,启动成功后会返回一个sdkappid维度唯一的任务id(TaskId)。您需要保存该TaskId,后续需要依赖此TaskId更新任务和结束任务。
298
- 2、UpdatePublishCdnStream:更新指定的混流转推任务,包括:更新视频画面的布局、更新混音列表、更新转推cdn的地址列表以及更新回推房间列表。
299
- 3、StopPublishCdnStream:停止指定的混流转推任务。
300
-
301
- 您可以通过此套接口实现目标:
302
- 1、设置最终混流的画质和音质,包括视频分辨率、视频帧率、视频码率,和音频质量。
303
- 2、设置每一路画面的布局位置,您只需要设置一次,后续您指定的混流用户进房上行音视频时,排版引擎会自动将该用户的画面混合到您指定的布局位置。同时您可以使用更新接口调整画面的布局位置。
304
- 3、设置多个cdn转推的目的地址,一个转推任务最多可以同时设置10个cdn转推地址,如果您需要转推非腾讯云的cdn地址时,需要联系腾讯云开通能力。
305
- 4、设置多个回推房间列表,一个转推任务最多可以同时将混流回推到10个TRTC房间。
306
-
307
- 目前已经支持如下几种布局模版,其中动态布局模版(悬浮模板、九宫格模板、屏幕分享模板)只支持单个TRTC房间,自定义模版支持混合多个TRTC房间内的音视频流。具体说明如下:
308
- 1、悬浮模板:第一个进入房间的用户的视频画面会铺满整个屏幕,其他用户的视频画面从左下角依次水平排列,显示为小画面,最多4行,每行4个,小画面悬浮于大画面之上。最多支持1个大画面和15个小画面,如果用户只发送音频默认不占布局配置,也支持设置。每个子画面默认采用居中裁剪的方式进行渲染,也支持统一设置子画面的渲染方式。
309
- 2、九宫格模板:所有用户的视频画面大小一致,平分整个屏幕,人数越多,每个画面的尺寸越小。最多支持16个画面,如果用户只发送音频,默认不占布局配置,也支持设置。每个子画面默认采用居中裁剪的方式进行渲染,也支持统一设置子画面的渲染方式。
310
- 3、屏幕分享模板:适合视频会议和在线教育场景的布局,屏幕分享(或者主讲的摄像头)始终占据屏幕左侧的大画面位置,需要您明确设置占据大画面的混流用户信息。其他用户依次垂直排列于右侧,最多两列,每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时,左侧大画面为了保持内容的完整性采用缩放方式处理,右侧小画面采用裁剪方式处理,也支持统一设置子画面的渲染方式。
311
- 4、自定义布局模版:支持您主动根据业务需要设置布局位置,每个预设的布局位置支持具名设置(具名设置需要明确指定房间号和用户名)和不具名设置。当一个子画面具名设置时,该位置就为该用户预留,用户进房且上行音视频数据时会自动占据该位置,其它用户不会占据该位置。当预设的布局位置未具名时,排版引擎会根据进房间顺序自动填充,预设位置填满时,不再混合其它用户的画面和声音。每个子画面位置支持设置占位图(BackgroundImageUrl),当用户未进房或者只上行音频数据时,该位置画面可显示对应的占位图画面。
312
-
313
- 您可以控制台开通旁路转推回调功能实现转推cdn状态的事件监控,具体说明请参考官网文档:[旁路转推回调说明](https://cloud.tencent.com/document/product/647/88552)
314
- 您使用转推api时根据使用特性可能会产生如下费用:
315
- MCU混流转码费用请参考文档:[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)
316
- 转推非腾讯云CDN费用请参考文档:[云端转推计费说明](https://cloud.tencent.com/document/product/647/82155)
317
-
318
- 参数的使用说明:
319
- 1、AgentParams:每个转推任务会拉起一个机器人用户进入TRTC房间进行拉流,您需要通过AgentParams.UserId参数进行设置,这个机器人id不能和房间中的普通用户id冲突,否则会导致转推任务由于机器人用户被踢出TRTC房间而异常结束,您可以通过增加特殊前缀的方式规避。您可以通过设置AgentParams.MaxIdleTime控制转推任务的自动结束,当设置此参数时,所有参与混流转推的主播持续离开TRTC房间超过MaxIdleTime的时长,自动停止转推任务。注意:参与混流转推的主播仅是停止音视频上行,转推任务不会自动停止。
320
- 2、WithTranscoding:如果需要将多路音视频流混合到一路时,WithTranscoding必须设置为1。
321
- 3、AudioParams:转推任务音频参数和视频参数是分开设置的,若您想要将指定的用户音频进行混音时,需要明确设置AudioParams.SubscribeAudioList。若您不设置AudioParams.SubscribeAudioList,混音引擎会自动将TRTC房间中所有用户的音频混合。若您想要混合TRTC房间除指定用户之外的所有用户的声音,可以通过AudioParams.UnSubscribeAudioList设置音频黑名单列表。
322
- 4、VideoParams:若您想要将用户的视频混合,可以通过VideoParams设置,若只想要混纯音频,则不用设置VideoParams参数。您可以通过VideoParams.LayoutParams.MixLayoutMode设置画面的布局模式,包括:动态布局(1:悬浮布局(默认),2:屏幕分享布局,3:九宫格布局)和自定义布局。动态布局模式由排版引擎按照固定的布局自动混合,不需要设置VideoParams.LayoutParams.MixLayoutList。当使用悬浮布局和屏幕分享布局时,您可以通过设置VideoParams.LayoutParams.MaxVideoUser参数指定大画面用户。自定义布局模式提供给您自主布局画面的能力,可以通过VideoParams.LayoutParams.MixLayoutList参数指定每个用户所在的布局位置。在每个布局参数中,您可以通过用户媒体流参数(UserMediaStream)指定这个布局位置为指定的用户预留,也可以不设置UserMediaStream,由排版引擎按照用户进入TRTC房间的顺序自动填充,另外您也可以设置每个布局位置的渲染方式(RenderMode)和裁剪方式(CustomCrop)。
323
- 5、VideoParams.WaterMarkList:若您想要混流画面中叠加水印,可以通过VideoParams.WaterMarkList参数设置,支持图片水印和文字水印,支持透明通道。
324
- 6、SingleSubscribeParams:若您想要将TRTC房间中的一路单流推到CDN,可以使用SingleSubscribeParams参数设置,此时需要将WithTranscoding参数设置为0。
325
- 7、PublishCdnParams.N:若您想要推流到CDN,可以使用PublishCdnParams.N参数设置,支持最多同时推流到10个CDN地址。若转推地址是腾讯云CDN时,请将IsTencentCdn明确设置为1;若您有转推非腾讯云CDN的需求时,请联系腾讯云技术支持开通,转推非腾讯云会产生转推费用,费用说明请参考官网文档:[云端转推计费说明](https://cloud.tencent.com/document/product/647/82155)。
326
- 8、FeedBackRoomParams.N:若您想要将混合的音视频流回推到TRTC房间,可以使用FeedBackRoomParams.N参数设置,支持最多同时推10路流回TRTC房间。您需要指定回推的TRTC房间号和机器人ID(UserId),机器人ID不能与普通用户ID冲突,否则会导致转推任务由于机器人用户被踢出TRTC房间而异常结束,您可以通过增加特殊前缀的方式规避。
327
- 9、SeiParams:若您想要混合的音视频流中增加SEI信息时,可以使用SeiParams参数设置,支持音量布局SEI和叠加转推请求中的SEI,其中音量布局SEI的内容是固定的json结构,具体请看本章节后续的SEI说明。您可以通过FollowIdr参数设置SEI跟随关键帧一起发送。音量布局sei的说明如下:
328
- 如果您的CDN观众端需要识别到参与混流的主播位置,以及需要识别到参与混流的主播的音量信息,可以通过音量布局sei实现。音量布局sei的payload内容及参数说明如下:
329
-
330
- ```
331
- {
332
- "app_data":"",
333
- "canvas":{
334
- "w":1080,
335
- "h":960
336
- },
337
- "regions":[
338
- {
339
- "uid":"65949987242835883c",
340
- "zorder":2,
341
- "volume":45,
342
- "x":270,
343
- "y":480,
344
- "w":540,
345
- "h":480
346
- },
347
- {
348
- "uid":"659c9d8d242b328d31",
349
- "zorder":2,
350
- "volume":0,
351
- "x":0,
352
- "y":0,
353
- "w":540,
354
- "h":480
355
- },
356
- {
357
- "uid":"64989a82272b308c",
358
- "zorder":2,
359
- "volume":91,
360
- "x":540,
361
- "y":0,
362
- "w":540,
363
- "h":480
364
- }
365
- ],
366
- "ver":"1.0",
367
- "ts":1648544726
368
- }
369
- ```
370
- canvas:这个是混流信令中VideoEncode设置的宽高,即:混流输出的整个画布宽高。
371
- regions:里面是真实混入的用户id和对应的子画面位置,若参与混流的用户未进入TRTC房间或者未开启视频上行,regions中不会包含该用户。
372
- uid:代表参与混流的用户ID。
373
- zorder:参与混流userid在混流输出的层级。
374
- x/y:参与混流userid的子画面在画布的坐标。
375
- w/h:参与混流userid的子画面的大小。
376
- volume:代表混流用户的音量,取值范围为0-100,值越大,代表该用户参与混流时的音量越大。
377
- ts:是输出sei的服务器本地秒级时戳。
378
- ver:可以忽略。
379
-
380
- 其它使用注意事项:
381
- 1、使用混流转推接口时,您需要先调用启动转推任务接口(StartPublishCdnStream),获取启动转推任务响应中的任务ID标识(TaskId)。后续传入任务ID标识(TaskId)来更新转推任务(UpdatePublishCdnStream)和停止转推任务(StopPublishCdnStream)。
382
- 2、转推API不支持发起到TRTC控制台配置的自动旁路任务,以及通过TRTC SDK进房接口中设置的自定义流ID的旁路任务。
383
- 3、为了确保转推链接的稳定,同一个转推任务不支持纯音频、音视频、纯视频之间的切换。
384
- 4、为了确保转推链接的稳定,不支持update时更新视频参数(codec)和音频参数(codec、采样率、码率、声道数)。
385
- 5、发起单流旁路任务时,AudioParams和VideoParams都填写表示音视频旁路,如果仅填写AudioParams表示纯音频旁路,任务进行过程中不支持纯音频到音视频的切换。音视频旁路时,VideoParams中的Width、Height、Fps、BitRate、Gop需要按照真实上行参数填写。
386
- 6、更新请求中必须携带SequenceNumber参数,用于防止请求乱序。客户保证对同一个任务更新时的SequenceNumber参数递增,否则会导致混流任务更新失败。
387
- 7、调用api时region选择说明:如果应用id是1400xxx时,region可填北京、上海、广州、香港,如果您的cdn观众主要在海外,请选择香港;如果应用id是200xxx或400xxx时,region请选择新加坡。
388
- 8、回推到TRTC房间的流不会参与其他回推房间任务的混流,满足下面条件之一时,可以参与其他转推cdn任务的混流: (1) 转推cdn任务在视频参数中通过具名方式指定推流机器人参与混流;(2) 转推cdn任务在音频参数中通过白名单方式指定推流机器人参与混流;(3) 转推cdn任务参与混流用户的房间号与回推机器人对应混流用户的房间号完全不同。
389
- 9、您可以在主播进房前,提前创建转推任务,结束转推任务时需要主动调用停止接口。如果您没有调用停止转推任务接口时,腾讯云后台会按照所有参与混流的用户没有任何数据上行的时间算起,直到超过启动转推任务时设置的超时时间(AgentParams.MaxIdleTime)为止,自动停止混流转推任务。
294
+ * 接口说明:
295
+ 启动一个混流转推任务,将 TRTC 房间的多路音视频流混成一路音视频流,编码后推到直播 CDN 或者回推到 TRTC 房间。也支持不转码直接转推 TRTC 房间的单路流。启动成功后,会返回一个 SdkAppid 维度唯一的任务 Id(TaskId)。您需要保存该 TaskId,后续需要依赖此 TaskId 更新和结束任务。可以参考文档: [功能说明](https://cloud.tencent.com/document/product/647/84721#b9a855f4-e38c-4616-9b07-fc44e0e8282a) 和 [常见问题](https://cloud.tencent.com/document/product/647/62620)
296
+
297
+ 注意:
298
+ 您可以在控制台开通旁路转推回调功能,对转推 CDN 状态的事件进行监控,回调请参考文档:[旁路转推回调说明](https://cloud.tencent.com/document/product/647/88552)
299
+ 您发起混流转推任务时,可能会产生如下费用:
300
+ MCU 混流转码费用,请参考文档:[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)
301
+ 转推非腾讯云 CDN 费用,请参考文档:[云端转推计费说明](https://cloud.tencent.com/document/product/647/82155)
390
302
  */
391
303
  async StartPublishCdnStream(
392
304
  req: StartPublishCdnStreamRequest,
@@ -709,8 +621,9 @@ peakCurrentUsers:峰值同时在线人数。
709
621
  }
710
622
 
711
623
  /**
712
- * 停止转推任务。
713
- */
624
+ * 接口说明:
625
+ 停止指定的混流转推任务。如果没有调用 Stop 接口停止任务,所有参与混流转推的主播离开 TRTC 房间超过 AgentParams.MaxIdleTime 设置的时间后,任务也会自动停止。
626
+ */
714
627
  async StopPublishCdnStream(
715
628
  req: StopPublishCdnStreamRequest,
716
629
  cb?: (error: string, rep: StopPublishCdnStreamResponse) => void
@@ -934,8 +847,9 @@ peakCurrentUsers:峰值同时在线人数。
934
847
  }
935
848
 
936
849
  /**
937
- * 更新转推任务。
938
- 注:请参见启动转推任务的接口说明和使用说明。
850
+ * 接口说明:
851
+ 成功发起混流转推后,可以使用此接口来更新任务。仅在任务进行时有效,任务退出后更新将会返回错误。更新操作为增量更新模式。
852
+ 注意:为了保障推流的稳定性,更新不支持任务在纯音频、音视频、纯视频之间进行切换。
939
853
  */
940
854
  async UpdatePublishCdnStream(
941
855
  req: UpdatePublishCdnStreamRequest,