tencentcloud-sdk-nodejs-intl-en 3.0.366 → 3.0.370

package/tencentcloud/live/v20180801/live_client.js

@@ -190,6 +190,7 @@ const DescribeConcurrentRecordStreamNumRequest = models.DescribeConcurrentRecord
 const DescribePlayErrorCodeSumInfoListRequest = models.DescribePlayErrorCodeSumInfoListRequest;
 const ModifyLiveCertRequest = models.ModifyLiveCertRequest;
 const CommonMixControlParams = models.CommonMixControlParams;
+const TranscodeTotalInfo = models.TranscodeTotalInfo;
 const DescribeAreaBillBandwidthAndFluxListResponse = models.DescribeAreaBillBandwidthAndFluxListResponse;
 const ForbidLiveDomainRequest = models.ForbidLiveDomainRequest;
 const DescribeLiveRecordRulesRequest = models.DescribeLiveRecordRulesRequest;
@@ -216,7 +217,7 @@ const ModifyLiveTranscodeTemplateRequest = models.ModifyLiveTranscodeTemplateReq
 const ModifyLiveDomainCertResponse = models.ModifyLiveDomainCertResponse;
 const EnableLiveDomainRequest = models.EnableLiveDomainRequest;
 const DescribeAllStreamPlayInfoListResponse = models.DescribeAllStreamPlayInfoListResponse;
-const ForbidLiveDomainResponse = models.ForbidLiveDomainResponse;
+const DescribeLiveTranscodeTotalInfoResponse = models.DescribeLiveTranscodeTotalInfoResponse;
 const DescribeLiveSnapshotRulesRequest = models.DescribeLiveSnapshotRulesRequest;
 const CreateRecordTaskRequest = models.CreateRecordTaskRequest;
 const CreateLiveTranscodeRuleResponse = models.CreateLiveTranscodeRuleResponse;
@@ -260,7 +261,9 @@ const DescribeVisitTopSumInfoListResponse = models.DescribeVisitTopSumInfoListRe
 const CreateLiveSnapshotRuleResponse = models.CreateLiveSnapshotRuleResponse;
 const DelayInfo = models.DelayInfo;
 const DescribeLiveStreamEventListResponse = models.DescribeLiveStreamEventListResponse;
+const ForbidLiveDomainResponse = models.ForbidLiveDomainResponse;
 const DescribeLiveCallbackRulesResponse = models.DescribeLiveCallbackRulesResponse;
+const DescribeLiveTranscodeTotalInfoRequest = models.DescribeLiveTranscodeTotalInfoRequest;
 const CreateRecordTaskResponse = models.CreateRecordTaskResponse;
 const ForbidStreamInfo = models.ForbidStreamInfo;
 const ResumeDelayLiveStreamResponse = models.ResumeDelayLiveStreamResponse;
@@ -746,6 +749,20 @@ Note: if you are to set the delay before stream push, set it at least 5 minutes
         this.request("DeleteLiveTranscodeRule", req, resp, cb);
     }
 
+    /**
+     * This API is used to query your total usage of the transcoding service in the last 30 days.
+Notes:
+If the start time and end time are on the same day, the data returned will be on a 5-minute basis.
+If not or if the data of specified domains is queried, the data returned will be on an hourly basis.
+     * @param {DescribeLiveTranscodeTotalInfoRequest} req
+     * @param {function(string, DescribeLiveTranscodeTotalInfoResponse):void} cb
+     * @public
+     */
+    DescribeLiveTranscodeTotalInfo(req, cb) {
+        let resp = new DescribeLiveTranscodeTotalInfoResponse();
+        this.request("DescribeLiveTranscodeTotalInfo", req, resp, cb);
+    }
+
     /**
      * This API is used to delete a screencapturing rule.
      * @param {DeleteLiveSnapshotRuleRequest} req
@@ -939,7 +956,7 @@ Note: to query by `AppName`, you need to submit a ticket first. After your appli
     }
 
     /**
-     * This API is used to end a recording prematurely and terminate an ongoing recording task. After the task is successfully terminated, it will not restart.
+     * This API is used to terminate an ongoing recording task and generate a recording file.
      * @param {StopRecordTaskRequest} req
      * @param {function(string, StopRecordTaskResponse):void} cb
      * @public
@@ -1220,8 +1237,8 @@ Note: Up to 10,000 entries can be queried per page. More data can be obtained by
     }
 
     /**
-     * After a recording template is created and a template ID is successfully returned, you need to call the [CreateLiveRecordRule](https://intl.cloud.tencent.com/document/product/267/32615?from_cn_redirect=1) API and bind the template ID to the stream.
-<br>Recording-related document: [LVB Recording](https://intl.cloud.tencent.com/document/product/267/32739?from_cn_redirect=1).
+     * This API is used to create a recording template. You can create up to 50 templates. To use a template, you need to call the [CreateLiveRecordRule](https://intl.cloud.tencent.com/document/product/267/32615?from_cn_redirect=1) API to bind the template ID returned by this API to a stream.
+<br>More on recording: [Live Recording](https://intl.cloud.tencent.com/document/product/267/32739?from_cn_redirect=1)
      * @param {CreateLiveRecordTemplateRequest} req
      * @param {function(string, CreateLiveRecordTemplateResponse):void} cb
      * @public
@@ -1334,15 +1351,16 @@ Note: only one screencapturing template can be associated with one domain name.
     }
 
     /**
-     * This API is used to get the stream status, such as active, inactive, or disabled.
-Note: this API is used to query the stream status, and should not be relied too much upon in important business scenarios.
+     * This API is used to get the stream status, which may be active, inactive, or disabled.
 
 Notes:
-1. You should not rely on the results returned by this API to initiate/interrupt live streams.
-2. The application can get and store the status of live rooms via [Stream Push and Interruption Event Notification](https://intl.cloud.tencent.com/document/product/267/47025?from_cn_redirect=1).
-3. You can use the [DescribeLiveStreamOnlineList](https://intl.cloud.tencent.com/document/product/267/20472?from_cn_redirect=1) API to regularly (with the interval larger than 1 minute) check the status of live rooms monitored by the application.
-4. If you find that a stream is inactive using the stream status query API, you can use other above-mentioned methods to check its status.
-5. If access or resolution errors occur when you use the API to query, you can regard the stream as active, and do not perform operations on the application.
+This API allows you to query the status of a stream in real time. Given external factors such as network jitter, note the following when you determine whether a host is online:
+1. If possible, use your own logic of stream starting/stopping in a room, such as streaming signaling on the client and the online heartbeat of a host, to determine whether the host is online.
+2. If your application does not provide the room management feature, use the following methods to determine whether a host is online:
+2.1 Use the [live stream callback](https://intl.cloud.tencent.com/document/product/267/20388?from_cn_redirect=1).
+2.2 Call [DescribeLiveStreamOnlineList](https://intl.cloud.tencent.com/document/api/267/20472?from_cn_redirect=1) on a regular basis (interval > 1 min).
+2.3 Call this API.
+2.4 A host is considered to be online if the result returned by any of the above methods indicates so. If an API call times out or a parsing error occurs, to minimize the impact on your business, CSS will also consider the host online.
      * @param {DescribeLiveStreamStateRequest} req
      * @param {function(string, DescribeLiveStreamStateResponse):void} cb
      * @public

package/tencentcloud/live/v20180801/models.js

@@ -2295,6 +2295,21 @@ Default value: 5.
          */
         this.ServiceName = null;
 
+        /**
+         * Region. Valid values:
+China Mainland
+Asia Pacific I
+Asia Pacific II
+Asia Pacific III
+Europe
+North America
+South America
+Middle East
+Africa
+         * @type {Array.<string> || null}
+         */
+        this.RegionNames = null;
+
     }
 
     /**
@@ -2310,6 +2325,7 @@ Default value: 5.
         this.MainlandOrOversea = 'MainlandOrOversea' in params ? params.MainlandOrOversea : null;
         this.Granularity = 'Granularity' in params ? params.Granularity : null;
         this.ServiceName = 'ServiceName' in params ? params.ServiceName : null;
+        this.RegionNames = 'RegionNames' in params ? params.RegionNames : null;
 
     }
 }
@@ -3531,9 +3547,10 @@ class CommonMixLayoutParams extends  AbstractModel {
         super();
 
         /**
-         * Input layer. Value range: [1,16].
-1) For `image_layer` of background stream (i.e., main host video image or canvas), enter 1.
-2) For audio stream mix, this parameter is also required.
+         * Input layer. Value range: [1,16]
+(1) For the background stream, i.e., the room owner’s image or the canvas, set this parameter to `1`.
+(2) This parameter is required for audio-only stream mixing as well.
+Note that two inputs cannot have the same `ImageLayer` value.
          * @type {number || null}
          */
         this.ImageLayer = null;
@@ -3551,24 +3568,24 @@ If this parameter is left empty, 0 will be used by default.
         this.InputType = null;
 
         /**
-         * Output width of input video image. Value range:
+         * Output height of input video image. Value range:
 Pixel: [0,2000]
 Percentage: [0.01,0.99]
-If this parameter is left empty, the input stream width will be used by default.
-If percentage is used, the expected output is (percentage * background width).
+If this parameter is left empty, the input stream height will be used by default.
+If percentage is used, the expected output is (percentage * background height).
          * @type {number || null}
          */
-        this.ImageWidth = null;
+        this.ImageHeight = null;
 
         /**
-         * Output height of input video image. Value range:
+         * Output width of input video image. Value range:
 Pixel: [0,2000]
 Percentage: [0.01,0.99]
-If this parameter is left empty, the input stream height will be used by default.
-If percentage is used, the expected output is (percentage * background height).
+If this parameter is left empty, the input stream width will be used by default.
+If percentage is used, the expected output is (percentage * background width).
          * @type {number || null}
          */
-        this.ImageHeight = null;
+        this.ImageWidth = null;
 
         /**
          * X-axis offset of input in output video image. Value range:
@@ -3623,8 +3640,8 @@ Gray: 0x999999
         }
         this.ImageLayer = 'ImageLayer' in params ? params.ImageLayer : null;
         this.InputType = 'InputType' in params ? params.InputType : null;
-        this.ImageWidth = 'ImageWidth' in params ? params.ImageWidth : null;
         this.ImageHeight = 'ImageHeight' in params ? params.ImageHeight : null;
+        this.ImageWidth = 'ImageWidth' in params ? params.ImageWidth : null;
         this.LocationX = 'LocationX' in params ? params.LocationX : null;
         this.LocationY = 'LocationY' in params ? params.LocationY : null;
         this.Color = 'Color' in params ? params.Color : null;
@@ -5845,7 +5862,7 @@ class PushDataInfo extends  AbstractModel {
         this.VideoFps = null;
 
         /**
-         * Pushed video bitrate in bps.
+         * Video bitrate (Kbps) for publishing
          * @type {number || null}
          */
         this.VideoSpeed = null;
@@ -5857,7 +5874,7 @@ class PushDataInfo extends  AbstractModel {
         this.AudioFps = null;
 
         /**
-         * Pushed audio bitrate in bps.
+         * Audio bitrate (Kbps) for publishing
          * @type {number || null}
          */
         this.AudioSpeed = null;
@@ -9091,6 +9108,62 @@ If you set this parameter to 1, SEI (Supplemental Enhanced Information) of the i
     }
 }
 
+/**
+ * Total usage of the transcoding service
+ * @class
+ */
+class TranscodeTotalInfo extends  AbstractModel {
+    constructor(){
+        super();
+
+        /**
+         * Usage time (Beijing time)
+Example: 2019-03-01 00:00:00
+         * @type {string || null}
+         */
+        this.Time = null;
+
+        /**
+         * Transcoding duration in minutes
+         * @type {number || null}
+         */
+        this.Duration = null;
+
+        /**
+         * Codec, with modules
+Examples:
+`liveprocessor_H264`: live transcoding-H264
+`liveprocessor_H265`: live transcoding-H265
+`topspeed_H264`: top speed codec-H264
+`topspeed_H265`: top speed codec-H265
+         * @type {string || null}
+         */
+        this.ModuleCodec = null;
+
+        /**
+         * Resolution
+Example: 540*480
+         * @type {string || null}
+         */
+        this.Resolution = null;
+
+    }
+
+    /**
+     * @private
+     */
+    deserialize(params) {
+        if (!params) {
+            return;
+        }
+        this.Time = 'Time' in params ? params.Time : null;
+        this.Duration = 'Duration' in params ? params.Duration : null;
+        this.ModuleCodec = 'ModuleCodec' in params ? params.ModuleCodec : null;
+        this.Resolution = 'Resolution' in params ? params.Resolution : null;
+
+    }
+}
+
 /**
  * DescribeAreaBillBandwidthAndFluxList response structure.
  * @class
@@ -9703,8 +9776,8 @@ class DescribeStreamPlayInfoListRequest extends  AbstractModel {
         this.StartTime = null;
 
         /**
-         * End time (Beijing time) in the format of yyyy-mm-dd HH:MM:SS.
-The difference between the start time and end time cannot be greater than 24 hours. Data in the last 30 days can be queried.
+         * End time (Beijing time) in the format of yyyy-mm-dd HH:MM:SS
+The start time and end time cannot be more than 24 hours apart and must be within the last 15 days.
          * @type {string || null}
          */
         this.EndTime = null;
@@ -9829,9 +9902,10 @@ It must be a multiple of 2. The original width is 0.
         this.NeedAudio = null;
 
         /**
-         * Height. Default value: 0.
-Value range: [0,3000]
-The value must be a multiple of 2, and 0 is the original height.
+         * Height. Default value: 0
+Value range: 0-3000
+The value must be a multiple of 2. The original height is `0`.
+This parameter is required for a top speed codec template (when `AiTransCode` is `1`).
          * @type {number || null}
          */
         this.Height = null;
@@ -10493,13 +10567,20 @@ class DescribeAllStreamPlayInfoListResponse extends  AbstractModel {
 }
 
 /**
- * ForbidLiveDomain response structure.
+ * DescribeLiveTranscodeTotalInfo response structure.
  * @class
  */
-class ForbidLiveDomainResponse extends  AbstractModel {
+class DescribeLiveTranscodeTotalInfoResponse extends  AbstractModel {
     constructor(){
         super();
 
+        /**
+         * List of transcoding data
+Note: This field may return `null`, indicating that no valid value can be found.
+         * @type {Array.<TranscodeTotalInfo> || null}
+         */
+        this.DataInfoList = null;
+
         /**
          * The unique request ID, which is returned for each request. RequestId is required for locating a problem.
          * @type {string || null}
@@ -10515,6 +10596,15 @@ class ForbidLiveDomainResponse extends  AbstractModel {
         if (!params) {
             return;
         }
+
+        if (params.DataInfoList) {
+            this.DataInfoList = new Array();
+            for (let z in params.DataInfoList) {
+                let obj = new TranscodeTotalInfo();
+                obj.deserialize(params.DataInfoList[z]);
+                this.DataInfoList.push(obj);
+            }
+        }
         this.RequestId = 'RequestId' in params ? params.RequestId : null;
 
     }
@@ -11030,8 +11120,8 @@ Only letters, digits, underscores, and hyphens can be contained.
         this.Description = null;
 
         /**
-         * Screencapturing interval in seconds. Default value: 10s.
-Value range: 5-300s.
+         * Screencapturing interval (s). Default value: 10
+Value range: 2-300
          * @type {number || null}
          */
         this.SnapshotInterval = null;
@@ -12424,6 +12514,34 @@ class DescribeLiveStreamEventListResponse extends  AbstractModel {
     }
 }
 
+/**
+ * ForbidLiveDomain response structure.
+ * @class
+ */
+class ForbidLiveDomainResponse extends  AbstractModel {
+    constructor(){
+        super();
+
+        /**
+         * The unique request ID, which is returned for each request. RequestId is required for locating a problem.
+         * @type {string || null}
+         */
+        this.RequestId = null;
+
+    }
+
+    /**
+     * @private
+     */
+    deserialize(params) {
+        if (!params) {
+            return;
+        }
+        this.RequestId = 'RequestId' in params ? params.RequestId : null;
+
+    }
+}
+
 /**
  * DescribeLiveCallbackRules response structure.
  * @class
@@ -12467,6 +12585,61 @@ class DescribeLiveCallbackRulesResponse extends  AbstractModel {
     }
 }
 
+/**
+ * DescribeLiveTranscodeTotalInfo request structure.
+ * @class
+ */
+class DescribeLiveTranscodeTotalInfoRequest extends  AbstractModel {
+    constructor(){
+        super();
+
+        /**
+         * Start time (Beijing time)
+Format: yyyy-mm-dd HH:MM:SS
+         * @type {string || null}
+         */
+        this.StartTime = null;
+
+        /**
+         * End time (Beijing time)
+Format: yyyy-mm-dd HH:MM:SS
+         * @type {string || null}
+         */
+        this.EndTime = null;
+
+        /**
+         * List of push domains to query. If this parameter is left empty, the data of all domains is queried.
+If this parameter is specified, the data returned will be on an hourly basis.
+         * @type {Array.<string> || null}
+         */
+        this.PushDomains = null;
+
+        /**
+         * Valid values:
+`Mainland`: queries transcoding data in the Chinese mainland
+`Oversea`: queries transcoding data outside the Chinese mainland
+By default, the data both in and outside the Chinese mainland is queried.
+         * @type {string || null}
+         */
+        this.MainlandOrOversea = null;
+
+    }
+
+    /**
+     * @private
+     */
+    deserialize(params) {
+        if (!params) {
+            return;
+        }
+        this.StartTime = 'StartTime' in params ? params.StartTime : null;
+        this.EndTime = 'EndTime' in params ? params.EndTime : null;
+        this.PushDomains = 'PushDomains' in params ? params.PushDomains : null;
+        this.MainlandOrOversea = 'MainlandOrOversea' in params ? params.MainlandOrOversea : null;
+
+    }
+}
+
 /**
  * CreateRecordTask response structure.
  * @class
@@ -13188,6 +13361,7 @@ module.exports = {
     DescribePlayErrorCodeSumInfoListRequest: DescribePlayErrorCodeSumInfoListRequest,
     ModifyLiveCertRequest: ModifyLiveCertRequest,
     CommonMixControlParams: CommonMixControlParams,
+    TranscodeTotalInfo: TranscodeTotalInfo,
     DescribeAreaBillBandwidthAndFluxListResponse: DescribeAreaBillBandwidthAndFluxListResponse,
     ForbidLiveDomainRequest: ForbidLiveDomainRequest,
     DescribeLiveRecordRulesRequest: DescribeLiveRecordRulesRequest,
@@ -13214,7 +13388,7 @@ module.exports = {
     ModifyLiveDomainCertResponse: ModifyLiveDomainCertResponse,
     EnableLiveDomainRequest: EnableLiveDomainRequest,
     DescribeAllStreamPlayInfoListResponse: DescribeAllStreamPlayInfoListResponse,
-    ForbidLiveDomainResponse: ForbidLiveDomainResponse,
+    DescribeLiveTranscodeTotalInfoResponse: DescribeLiveTranscodeTotalInfoResponse,
     DescribeLiveSnapshotRulesRequest: DescribeLiveSnapshotRulesRequest,
     CreateRecordTaskRequest: CreateRecordTaskRequest,
     CreateLiveTranscodeRuleResponse: CreateLiveTranscodeRuleResponse,
@@ -13258,7 +13432,9 @@ module.exports = {
     CreateLiveSnapshotRuleResponse: CreateLiveSnapshotRuleResponse,
     DelayInfo: DelayInfo,
     DescribeLiveStreamEventListResponse: DescribeLiveStreamEventListResponse,
+    ForbidLiveDomainResponse: ForbidLiveDomainResponse,
     DescribeLiveCallbackRulesResponse: DescribeLiveCallbackRulesResponse,
+    DescribeLiveTranscodeTotalInfoRequest: DescribeLiveTranscodeTotalInfoRequest,
     CreateRecordTaskResponse: CreateRecordTaskResponse,
     ForbidStreamInfo: ForbidStreamInfo,
     ResumeDelayLiveStreamResponse: ResumeDelayLiveStreamResponse,

package/tencentcloud/redis/v20180412/models.js

@@ -4123,6 +4123,12 @@ class KillMasterGroupRequest extends  AbstractModel {
          */
         this.Password = null;
 
+        /**
+         * Node information of a single-AZ deployed instance
+         * @type {Array.<number> || null}
+         */
+        this.ShardIds = null;
+
     }
 
     /**
@@ -4134,6 +4140,7 @@ class KillMasterGroupRequest extends  AbstractModel {
         }
         this.InstanceId = 'InstanceId' in params ? params.InstanceId : null;
         this.Password = 'Password' in params ? params.Password : null;
+        this.ShardIds = 'ShardIds' in params ? params.ShardIds : null;
 
     }
 }

package/tencentcloud/redis/v20180412/redis_client.js

@@ -369,7 +369,7 @@ class RedisClient extends AbstractClient {
     }
 
     /**
-     * This API is used to promote a replica node group of a multi-AZ deployed instance to master node group.
+     * This API is used to promote a replica node group of a multi-AZ deployed instance to master node group or a replica node of a single-AZ deployed instance to master node.
      * @param {ChangeReplicaToMasterRequest} req
      * @param {function(string, ChangeReplicaToMasterResponse):void} cb
      * @public