tencentcloud-sdk-python 3.0.1338__py2.py3-none-any.whl → 3.0.1372__py2.py3-none-any.whl

tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1338'
+__version__ = '3.0.1372'

tencentcloud/advisor/v20200721/models.py

@@ -26,13 +26,10 @@ class Conditions(AbstractModel):
     def __init__(self):
         r"""
         :param _ConditionId: 警告条件ID
-注意：此字段可能返回 null，表示取不到有效值。
         :type ConditionId: int
         :param _Level: 警告级别，2:中风险，3:高风险
-注意：此字段可能返回 null，表示取不到有效值。
         :type Level: int
         :param _LevelDesc: 警告级别描述
-注意：此字段可能返回 null，表示取不到有效值。
         :type LevelDesc: str
         :param _Desc: 警告条件描述
         :type Desc: str
@@ -45,7 +42,6 @@ class Conditions(AbstractModel):
     @property
     def ConditionId(self):
         """警告条件ID
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: int
         """
         return self._ConditionId
@@ -57,7 +53,6 @@ class Conditions(AbstractModel):
     @property
     def Level(self):
         """警告级别，2:中风险，3:高风险
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: int
         """
         return self._Level
@@ -69,7 +64,6 @@ class Conditions(AbstractModel):
     @property
     def LevelDesc(self):
         """警告级别描述
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
         """
         return self._LevelDesc
@@ -119,7 +113,6 @@ class DescribeStrategiesResponse(AbstractModel):
     def __init__(self):
         r"""
         :param _Strategies: 评估项列表
-注意：此字段可能返回 null，表示取不到有效值。
         :type Strategies: list of Strategies
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -130,7 +123,6 @@ class DescribeStrategiesResponse(AbstractModel):
     @property
     def Strategies(self):
         """评估项列表
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: list of Strategies
         """
         return self._Strategies
@@ -532,31 +524,22 @@ class Strategies(AbstractModel):
     def __init__(self):
         r"""
         :param _StrategyId: 评估项ID
-注意：此字段可能返回 null，表示取不到有效值。
         :type StrategyId: int
         :param _Name: 评估项名称
-注意：此字段可能返回 null，表示取不到有效值。
         :type Name: str
         :param _Desc: 评估项描述
-注意：此字段可能返回 null，表示取不到有效值。
         :type Desc: str
         :param _Product: 评估项对应产品ID
-注意：此字段可能返回 null，表示取不到有效值。
         :type Product: str
         :param _ProductDesc: 评估项对应产品名称
-注意：此字段可能返回 null，表示取不到有效值。
         :type ProductDesc: str
         :param _Repair: 评估项优化建议
-注意：此字段可能返回 null，表示取不到有效值。
         :type Repair: str
         :param _GroupId: 评估项类别ID
-注意：此字段可能返回 null，表示取不到有效值。
         :type GroupId: int
         :param _GroupName: 评估项类别名称
-注意：此字段可能返回 null，表示取不到有效值。
         :type GroupName: str
         :param _Conditions: 评估项风险列表
-注意：此字段可能返回 null，表示取不到有效值。
         :type Conditions: list of Conditions
         """
         self._StrategyId = None
@@ -572,7 +555,6 @@ class Strategies(AbstractModel):
     @property
     def StrategyId(self):
         """评估项ID
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: int
         """
         return self._StrategyId
@@ -584,7 +566,6 @@ class Strategies(AbstractModel):
     @property
     def Name(self):
         """评估项名称
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
         """
         return self._Name
@@ -596,7 +577,6 @@ class Strategies(AbstractModel):
     @property
     def Desc(self):
         """评估项描述
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
         """
         return self._Desc
@@ -608,7 +588,6 @@ class Strategies(AbstractModel):
     @property
     def Product(self):
         """评估项对应产品ID
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
         """
         return self._Product
@@ -620,7 +599,6 @@ class Strategies(AbstractModel):
     @property
     def ProductDesc(self):
         """评估项对应产品名称
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
         """
         return self._ProductDesc
@@ -632,7 +610,6 @@ class Strategies(AbstractModel):
     @property
     def Repair(self):
         """评估项优化建议
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
         """
         return self._Repair
@@ -644,7 +621,6 @@ class Strategies(AbstractModel):
     @property
     def GroupId(self):
         """评估项类别ID
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: int
         """
         return self._GroupId
@@ -656,7 +632,6 @@ class Strategies(AbstractModel):
     @property
     def GroupName(self):
         """评估项类别名称
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
         """
         return self._GroupName
@@ -668,7 +643,6 @@ class Strategies(AbstractModel):
     @property
     def Conditions(self):
         """评估项风险列表
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: list of Conditions
         """
         return self._Conditions

tencentcloud/ams/v20201229/ams_client.py

@@ -89,8 +89,19 @@ class AmsClient(AbstractClient):
 
         ### 功能使用说明：
         - 前往“[内容安全控制台-音频内容安全](https://console.cloud.tencent.com/cms)”开启使用音频内容安全服务，首次开通可获得**10小时**免费调用时长，有效期为1个月。
-        - 默认接口请求频率限制：**20次/秒**，对于异步审核任务（点播音频），超出频率限制的请求会自动排入待审核队列，对于同步审核任务（直播音频），超出频率限制将会报错。
-        - 默认并发审核路数限制：点播默认10路，异步审核任务（点播音频）数量超过并发审核路数时，将会进入排队；直播默认100路，同步审核任务（直播音频）超过并发审核路数，接口会返回错误。
+
+        ### 审核并发限制说明:
+
+        - **点播音频（异步审核）**
+            - 默认并发路数：10
+            - 队列处理机制：
+                - 当并发任务达到上限时，新任务进入队列等待处理;
+                -  新送审任务优先处理，旧任务往后排;
+        - **直播音频（异步审核）**
+            - 默认并发路数：100
+            - 队列处理机制：
+              - 运行中的审核任务达到上限时，新请求会提示超频错误：`RequestLimitExceeded`，错误详细为：`You have reached the concurrency limit`;
+              - 不支持排队;
 
         ### 接口功能说明：
         - 支持对音频流或音频文件进行检测，判断其中是否包含违规内容；
@@ -98,15 +109,15 @@ class AmsClient(AbstractClient):
         - 支持识别违规内容，包括：低俗、谩骂、色情、广告等场景；
         - 支持批量提交检测任务，检测任务列表**最多支持10个**。
 
-        ### 音频文件调用说明：
+        ### 音频文件流调用说明：
         - 音频文件大小支持：**文件 < 500M**；
         - 音频文件时长支持：**< 1小时**；
         - 音频码率类型支持：128 Kbps - 256 Kbps ；
         - 音频文件支持格式：wav、mp3、aac、flac、amr、3gp、 m4a、wma、ogg、ape；
         - （**当输入为视频文件时**）支持分离视频文件音轨，并对音频内容进行独立审核。
 
-        ### 音频流调用说明：
-        - 音频流时长支持：**< 3小时**；
+        ### 直播音频流调用说明：
+        - 音频流时长支持：**24小时以内**，超过需要重新推送审核任务；
         - 音频码率类型支持：128 Kbps - 256 Kbps ；
         - 音频流支持的传输协议：RTMP、HTTP、HTTPS；
         - 音频流格式支持的类型：rtp、srtp、rtmp、rtmps、mmsh、 mmst、hls、http、tcp、https、m3u8；
@@ -115,7 +126,7 @@ class AmsClient(AbstractClient):
         ### 直播断流处理说明：
         - 请确认已对接[取消任务](https://cloud.tencent.com/document/product/1219/53258)。
         - 如果直播任务取消/结束，则终止直播拉流并退出审核。
-        - 如果直播任务没有取消/结束，直播视频推流因故中断，产品将在将在10分钟内持续拉流重试。如果10分钟检测到音频切片数据，则恢复正常审核，反之，则终止拉流并退出审核。在拉流终止后，用户如有审核需求，需重新送审。
+        - 在直播任务未取消或结束的情况下，若推流中断（例如 `Operation not permitted` 错误），审核服务将在 10分钟内持续尝试重新拉流。检测到有效的图片或音频数据，审核将自动恢复正常；否则，10分钟后终止拉流并退出审核。此时如有需要，请重新提交审核请求。对于因网络问题导致的拉流失败（如 `HTTP 404 Not Found` 错误），系统将进行最多 16次重试。若成功获取有效数据，审核流程即刻恢复；若所有重试均失败，则同样终止拉流并退出审核，需用户重新送审。
 
         :param request: Request instance for CreateAudioModerationTask.
         :type request: :class:`tencentcloud.ams.v20201229.models.CreateAudioModerationTaskRequest`

tencentcloud/ams/v20201229/models.py

@@ -1501,11 +1501,12 @@ class CreateAudioModerationTaskRequest(AbstractModel):
         r"""
         :param _Tasks: 该字段表示输入的音频审核任务信息，具体输入内容请参见TaskInput数据结构的详细描述。<br> 备注：最多同时可创建**10个任务**。
         :type Tasks: list of TaskInput
-        :param _BizType: 该字段表示策略的具体编号，用于接口调度，在内容安全控制台中可配置。若不传入Biztype参数（留空），则代表采用默认的识别策略；传入则会在审核时根据业务场景采取不同的审核策略。<br>备注：Biztype仅为数字、字母与下划线的组合，长度为3-32个字符；不同Biztype关联不同的业务场景与识别能力策略，调用前请确认正确的Biztype。
+        :param _BizType: 该字段表示使用的策略的具体编号，该字段需要先在[内容安全控制台](https://console.cloud.tencent.com/cms/clouds/manage)中配置。
+备注：不同Biztype关联不同的业务场景与识别能力策略，调用前请确认正确的Biztype。
         :type BizType: str
-        :param _Type: 该字段表示输入的音频审核类型，取值为：**AUDIO**（点播音频）和 **LIVE_AUDIO**（直播音频），默认值为AUDIO。
+        :param _Type: 该字段表示输入的音频审核类型，取值含：**AUDIO**（点播音频）、**LIVE_AUDIO**（直播音频）、**AUDIO_AIGC**（AI生成识别）三种，默认值为AUDIO。
         :type Type: str
-        :param _Seed: 验证签名参数，具体可以参考[验签说明](https://cloud.tencent.com/document/product/1219/104000#42dd87d2-580f-46cf-a953-639a787d1eda)。
+        :param _Seed: 可选参数，该字段表示回调签名的key信息，用于保证数据的安全性。 签名方法为在返回的HTTP头部添加 X-Signature 的字段，值为： seed + body 的 SHA256 编码和Hex字符串，在收到回调数据后，可以根据返回的body，用 **sha256(seed + body)**, 计算出 `X-Signature` 进行验证。<br>具体使用实例可参考 [回调签名示例](https://cloud.tencent.com/document/product/1219/104000#42dd87d2-580f-46cf-a953-639a787d1eda)。
         :type Seed: str
         :param _CallbackUrl: 接收审核信息回调地址。如果设置了该字段，在审核过程中发现违规音频片段结果将发送至该接口。更多详情请参阅[回调配置说明](https://cloud.tencent.com/document/product/1219/104000)。
         :type CallbackUrl: str
@@ -1532,7 +1533,8 @@ class CreateAudioModerationTaskRequest(AbstractModel):
 
     @property
     def BizType(self):
-        """该字段表示策略的具体编号，用于接口调度，在内容安全控制台中可配置。若不传入Biztype参数（留空），则代表采用默认的识别策略；传入则会在审核时根据业务场景采取不同的审核策略。<br>备注：Biztype仅为数字、字母与下划线的组合，长度为3-32个字符；不同Biztype关联不同的业务场景与识别能力策略，调用前请确认正确的Biztype。
+        """该字段表示使用的策略的具体编号，该字段需要先在[内容安全控制台](https://console.cloud.tencent.com/cms/clouds/manage)中配置。
+备注：不同Biztype关联不同的业务场景与识别能力策略，调用前请确认正确的Biztype。
         :rtype: str
         """
         return self._BizType
@@ -1543,7 +1545,7 @@ class CreateAudioModerationTaskRequest(AbstractModel):
 
     @property
     def Type(self):
-        """该字段表示输入的音频审核类型，取值为：**AUDIO**（点播音频）和 **LIVE_AUDIO**（直播音频），默认值为AUDIO。
+        """该字段表示输入的音频审核类型，取值含：**AUDIO**（点播音频）、**LIVE_AUDIO**（直播音频）、**AUDIO_AIGC**（AI生成识别）三种，默认值为AUDIO。
         :rtype: str
         """
         return self._Type
@@ -1554,7 +1556,7 @@ class CreateAudioModerationTaskRequest(AbstractModel):
 
     @property
     def Seed(self):
-        """验证签名参数，具体可以参考[验签说明](https://cloud.tencent.com/document/product/1219/104000#42dd87d2-580f-46cf-a953-639a787d1eda)。
+        """可选参数，该字段表示回调签名的key信息，用于保证数据的安全性。 签名方法为在返回的HTTP头部添加 X-Signature 的字段，值为： seed + body 的 SHA256 编码和Hex字符串，在收到回调数据后，可以根据返回的body，用 **sha256(seed + body)**, 计算出 `X-Signature` 进行验证。<br>具体使用实例可参考 [回调签名示例](https://cloud.tencent.com/document/product/1219/104000#42dd87d2-580f-46cf-a953-639a787d1eda)。
         :rtype: str
         """
         return self._Seed

tencentcloud/antiddos/v20200309/antiddos_client.py

@@ -1015,31 +1015,6 @@ class AntiddosClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
-    def DescribeBlackWhiteIpList(self, request):
-        """接口变更
-
-        获取DDoS防护的IP黑白名单
-
-        :param request: Request instance for DescribeBlackWhiteIpList.
-        :type request: :class:`tencentcloud.antiddos.v20200309.models.DescribeBlackWhiteIpListRequest`
-        :rtype: :class:`tencentcloud.antiddos.v20200309.models.DescribeBlackWhiteIpListResponse`
-
-        """
-        try:
-            params = request._serialize()
-            headers = request.headers
-            body = self.call("DescribeBlackWhiteIpList", params, headers=headers)
-            response = json.loads(body)
-            model = models.DescribeBlackWhiteIpListResponse()
-            model._deserialize(response["Response"])
-            return model
-        except Exception as e:
-            if isinstance(e, TencentCloudSDKException):
-                raise
-            else:
-                raise TencentCloudSDKException(type(e).__name__, str(e))
-
-
     def DescribeCCLevelList(self, request):
         """获取边界防护CC防护等级列表
 
@@ -1592,31 +1567,6 @@ class AntiddosClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
-    def DescribeListProtectThresholdConfig(self, request):
-        """接口变更
-
-        获取防护阈值配置列表，包括DDoS的AI、等级、CC阈值开关等
-
-        :param request: Request instance for DescribeListProtectThresholdConfig.
-        :type request: :class:`tencentcloud.antiddos.v20200309.models.DescribeListProtectThresholdConfigRequest`
-        :rtype: :class:`tencentcloud.antiddos.v20200309.models.DescribeListProtectThresholdConfigResponse`
-
-        """
-        try:
-            params = request._serialize()
-            headers = request.headers
-            body = self.call("DescribeListProtectThresholdConfig", params, headers=headers)
-            response = json.loads(body)
-            model = models.DescribeListProtectThresholdConfigResponse()
-            model._deserialize(response["Response"])
-            return model
-        except Exception as e:
-            if isinstance(e, TencentCloudSDKException):
-                raise
-            else:
-                raise TencentCloudSDKException(type(e).__name__, str(e))
-
-
     def DescribeListProtocolBlockConfig(self, request):
         """获取DDoS防护的协议封禁配置列表