tencentcloud-sdk-python 3.0.1316__py2.py3-none-any.whl → 3.0.1317__py2.py3-none-any.whl

tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1316'
+__version__ = '3.0.1317'

tencentcloud/cdn/v20180606/errorcodes.py

@@ -26,6 +26,9 @@ FAILEDOPERATION = 'FailedOperation'
 # 域名配置更新操作失败，请重试或联系客服人员解决。
 FAILEDOPERATION_CDNCONFIGERROR = 'FailedOperation.CdnConfigError'
 
+# 证书不存在
+FAILEDOPERATION_SSLCERTNOTFOUND = 'FailedOperation.SslCertNotFound'
+
 # 内部错误。
 INTERNALERROR = 'InternalError'
 

tencentcloud/cdn/v20180606/models.py

@@ -3959,7 +3959,7 @@ off：关闭
         :param _AccessKey: 访问ID。
 注意：此字段可能返回 null，表示取不到有效值。
         :type AccessKey: str
-        :param _SecretKey: 密钥。
+        :param _SecretKey: 密钥，字段为脱敏返回。
 注意：此字段可能返回 null，表示取不到有效值。
         :type SecretKey: str
         :param _Region: 地域
@@ -4002,7 +4002,7 @@ off：关闭
 
     @property
     def SecretKey(self):
-        """密钥。
+        """密钥，字段为脱敏返回。
 注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
         """
@@ -20416,7 +20416,7 @@ off：关闭
         :param _AccessKey: 访问 ID
 注意：此字段可能返回 null，表示取不到有效值。
         :type AccessKey: str
-        :param _SecretKey: 密钥
+        :param _SecretKey: 密钥，字段为脱敏返回。
 注意：此字段可能返回 null，表示取不到有效值。
         :type SecretKey: str
         :param _Bucket: bucketname
@@ -20455,7 +20455,7 @@ off：关闭
 
     @property
     def SecretKey(self):
-        """密钥
+        """密钥，字段为脱敏返回。
 注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
         """
@@ -25597,7 +25597,7 @@ off：关闭
         :param _AccessKey: 访问ID。
 注意：此字段可能返回 null，表示取不到有效值。
         :type AccessKey: str
-        :param _SecretKey: 密钥。
+        :param _SecretKey: 密钥，字段为脱敏返回。
 注意：此字段可能返回 null，表示取不到有效值。
         :type SecretKey: str
         :param _Region: 地域
@@ -25640,7 +25640,7 @@ off：关闭
 
     @property
     def SecretKey(self):
-        """密钥。
+        """密钥，字段为脱敏返回。
 注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
         """
@@ -25705,7 +25705,7 @@ off：关闭
         :param _AccessKey: 访问ID。
 注意：此字段可能返回 null，表示取不到有效值。
         :type AccessKey: str
-        :param _SecretKey: 密钥。
+        :param _SecretKey: 密钥，字段位脱敏返回。
 注意：此字段可能返回 null，表示取不到有效值。
         :type SecretKey: str
         :param _Region: 地域。
@@ -25748,7 +25748,7 @@ off：关闭
 
     @property
     def SecretKey(self):
-        """密钥。
+        """密钥，字段位脱敏返回。
 注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
         """
@@ -27550,7 +27550,7 @@ off：关闭
         :param _AccessKey: 访问 ID
 注意：此字段可能返回 null，表示取不到有效值。
         :type AccessKey: str
-        :param _SecretKey: 密钥
+        :param _SecretKey: 密钥，字段为脱敏返回。
         :type SecretKey: str
         """
         self._Switch = None
@@ -27584,7 +27584,7 @@ off：关闭
 
     @property
     def SecretKey(self):
-        """密钥
+        """密钥，字段为脱敏返回。
         :rtype: str
         """
         return self._SecretKey

tencentcloud/cls/v20201016/models.py

@@ -25854,7 +25854,7 @@ class NoticeReceiver(AbstractModel):
         :type ReceiverType: str
         :param _ReceiverIds: 接收者。
 当ReceiverType为Uin时，ReceiverIds的值为用户uid。[子用户信息查询](https://cloud.tencent.com/document/api/598/53486)
-当ReceiverType为Group时，ReceiverIds的值为用户组id。[CAM用户组](https://cloud.tencent.com/document/product/598/14985)
+当ReceiverType为Group时，ReceiverIds的值为用户组id。[CAM用户组](https://cloud.tencent.com/document/product/598/34589)
         :type ReceiverIds: list of int
         :param _ReceiverChannels: 通知接收渠道。
 - Email - 邮件
@@ -25901,7 +25901,7 @@ class NoticeReceiver(AbstractModel):
     def ReceiverIds(self):
         """接收者。
 当ReceiverType为Uin时，ReceiverIds的值为用户uid。[子用户信息查询](https://cloud.tencent.com/document/api/598/53486)
-当ReceiverType为Group时，ReceiverIds的值为用户组id。[CAM用户组](https://cloud.tencent.com/document/product/598/14985)
+当ReceiverType为Group时，ReceiverIds的值为用户组id。[CAM用户组](https://cloud.tencent.com/document/product/598/34589)
         :rtype: list of int
         """
         return self._ReceiverIds

tencentcloud/common/abstract_client.py

@@ -39,6 +39,7 @@ from tencentcloud.common.http.request import RequestInternal
 from tencentcloud.common.profile.client_profile import ClientProfile, RegionBreakerProfile
 from tencentcloud.common.sign import Sign
 from tencentcloud.common.circuit_breaker import CircuitBreaker
+from tencentcloud.common.retry import NoopRetryer
 
 warnings.filterwarnings("ignore", module="tencentcloud", category=UserWarning)
 
@@ -428,11 +429,16 @@ class AbstractClient(object):
         return self.request.send_request(req)
 
     def call(self, action, params, options=None, headers=None):
-        resp = self._call(action, params, options, headers)
-        self._check_status(resp)
-        self._check_error(resp)
-        logger.debug("GetResponse: %s", ResponsePrettyFormatter(resp))
-        return resp.content
+
+        def _call_once():
+            resp = self._call(action, params, options, headers)
+            self._check_status(resp)
+            self._check_error(resp)
+            logger.debug("GetResponse: %s", ResponsePrettyFormatter(resp))
+            return resp
+
+        retryer = self.profile.retryer or NoopRetryer()
+        return retryer.send_request(_call_once).content
 
     def _call_with_region_breaker(self, action, params, options=None, headers=None):
         endpoint = self._get_endpoint()
@@ -508,23 +514,36 @@ class AbstractClient(object):
         :type options: dict
         :param options: request options, like {"SkipSign": False, "IsMultipart": False, "IsOctetStream": False, "BinaryParams": []}
         """
-        resp = self._call(action, params, options, headers)
-        self._check_status(resp)
-        self._check_error(resp)
-        logger.debug("GetResponse: %s", ResponsePrettyFormatter(resp))
-        return json.loads(resp.content)
+
+        def _call_once():
+            resp = self._call(action, params, options, headers)
+            self._check_status(resp)
+            self._check_error(resp)
+            logger.debug("GetResponse: %s", ResponsePrettyFormatter(resp))
+            return resp
+
+        retryer = self.profile.retryer or NoopRetryer()
+        return json.loads(retryer.send_request(_call_once).content)
 
     def call_sse(self, action, params, headers=None, options=None):
-        resp = self._call(action, params, options, headers)
-        self._check_status(resp)
-        self._check_error(resp)
-        return self._process_response_sse(resp)
+        def _call_once():
+            resp = self._call(action, params, options, headers)
+            self._check_status(resp)
+            self._check_error(resp)
+            return resp
+
+        retryer = self.profile.retryer or NoopRetryer()
+        return self._process_response_sse(retryer.send_request(_call_once))
 
     def _call_and_deserialize(self, action, params, resp_type, headers=None, options=None):
-        resp = self._call(action, params, options, headers)
-        self._check_status(resp)
-        self._check_error(resp)
-        return self._process_response(resp, resp_type)
+        def _call_once():
+            resp = self._call(action, params, options, headers)
+            self._check_status(resp)
+            self._check_error(resp)
+            return resp
+
+        retryer = self.profile.retryer or NoopRetryer()
+        return self._process_response(retryer.send_request(_call_once), resp_type)
 
     def _process_response(self, resp, resp_type):
         if resp.headers.get('Content-Type') == "text/event-stream":

tencentcloud/common/profile/client_profile.py

@@ -21,7 +21,7 @@ class ClientProfile(object):
     unsignedPayload = False
 
     def __init__(self, signMethod=None, httpProfile=None, language="zh-CN",
-                 disable_region_breaker=True, region_breaker_profile=None, request_client=None):
+                 disable_region_breaker=True, region_breaker_profile=None, request_client=None, retryer=None):
         """SDK profile.
 
         :param signMethod: The signature method, valid choice: HmacSHA1, HmacSHA256, TC3-HMAC-SHA256
@@ -55,13 +55,15 @@ class ClientProfile(object):
         elif request_client is not None:
             warnings.warn("RequestClient not match the regexp: ^[0-9a-zA-Z-_,;.]+$, ignored")
 
+        self.retryer = retryer
+
 
 class RegionBreakerProfile(object):
 
     def __init__(self, backup_endpoint="ap-guangzhou.tencentcloudapi.com",
                  max_fail_num=5,
                  max_fail_percent=0.75,
-                 window_interval=60*5,
+                 window_interval=60 * 5,
                  timeout=60,
                  max_requests=5):
         """RegionBreaker profile.
@@ -102,4 +104,3 @@ class RegionBreakerProfile(object):
             if len(region.split("-")) != 2:
                 return False
         return True
-

tencentcloud/common/retry.py

@@ -0,0 +1,62 @@
+import logging
+import time
+
+from tencentcloud.common.exception import TencentCloudSDKException
+
+
+class NoopRetryer(object):
+    def send_request(self, fn):
+        return fn()
+
+
+class StandardRetryer(object):
+    def __init__(self, max_attempts=3, backoff_fn=None, logger=None):
+        self._max_attempts = max_attempts
+        self._backoff_fn = backoff_fn or self.backoff
+        self._logger = logger
+
+    def send_request(self, fn):
+        resp = None
+        err = None
+
+        for n in range(self._max_attempts):
+            try:
+                resp = fn()
+            except TencentCloudSDKException as e:
+                err = e
+
+            if not self.should_retry(resp, err):
+                if err:
+                    raise err
+                return resp
+
+            sleep = self._backoff_fn(n)
+            self.on_retry(n, sleep, resp, err)
+            time.sleep(sleep)
+
+        raise err
+
+    @staticmethod
+    def should_retry(resp, err):
+        if not err:
+            return False
+
+        if not isinstance(err, TencentCloudSDKException):
+            return False
+
+        ec = err.get_code()
+        if ec in (
+                "ClientNetworkError", "ServerNetworkError", "RequestLimitExceeded",
+                "RequestLimitExceeded.UinLimitExceeded", "RequestLimitExceeded.GlobalRegionUinLimitExceeded"
+        ):
+            return True
+
+        return False
+
+    @staticmethod
+    def backoff(n):
+        return 2 ** n
+
+    def on_retry(self, n, sleep, resp, err):
+        if self._logger:
+            self._logger.debug("retry: n=%d sleep=%ss err=%s", n, sleep, err)

tencentcloud/cvm/v20170312/models.py

@@ -10528,11 +10528,25 @@ class ImportImageResponse(AbstractModel):
 
     def __init__(self):
         r"""
+        :param _ImageId: 镜像 ID
+        :type ImageId: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
         """
+        self._ImageId = None
         self._RequestId = None
 
+    @property
+    def ImageId(self):
+        """镜像 ID
+        :rtype: str
+        """
+        return self._ImageId
+
+    @ImageId.setter
+    def ImageId(self, ImageId):
+        self._ImageId = ImageId
+
     @property
     def RequestId(self):
         """唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
@@ -10546,6 +10560,7 @@ class ImportImageResponse(AbstractModel):
 
 
     def _deserialize(self, params):
+        self._ImageId = params.get("ImageId")
         self._RequestId = params.get("RequestId")
 
 

tencentcloud/ess/v20201111/models.py

@@ -20152,22 +20152,16 @@ class DescribeOrganizationGroupOrganizationsResponse(AbstractModel):
     def __init__(self):
         r"""
         :param _Total: 符合查询条件的资源实例总数量。
-注意：此字段可能返回 null，表示取不到有效值。
         :type Total: int
         :param _JoinedTotal: 已授权待激活的子企业总数量
-注意：此字段可能返回 null，表示取不到有效值。
         :type JoinedTotal: int
         :param _ActivedTotal: 已加入的企业数量(废弃,请使用ActivatedTotal)
-注意：此字段可能返回 null，表示取不到有效值。
         :type ActivedTotal: int
         :param _ExportUrl: 如果入参Export为 true 时使用，表示导出Excel的url
-注意：此字段可能返回 null，表示取不到有效值。
         :type ExportUrl: str
         :param _List: 成员企业信息列表
-注意：此字段可能返回 null，表示取不到有效值。
         :type List: list of GroupOrganization
         :param _ActivatedTotal: 已加入的子企业总数量
-注意：此字段可能返回 null，表示取不到有效值。
         :type ActivatedTotal: int
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -20183,7 +20177,6 @@ class DescribeOrganizationGroupOrganizationsResponse(AbstractModel):
     @property
     def Total(self):
         """符合查询条件的资源实例总数量。
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: int
         """
         return self._Total
@@ -20195,7 +20188,6 @@ class DescribeOrganizationGroupOrganizationsResponse(AbstractModel):
     @property
     def JoinedTotal(self):
         """已授权待激活的子企业总数量
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: int
         """
         return self._JoinedTotal
@@ -20209,7 +20201,6 @@ class DescribeOrganizationGroupOrganizationsResponse(AbstractModel):
         warnings.warn("parameter `ActivedTotal` is deprecated", DeprecationWarning) 
 
         """已加入的企业数量(废弃,请使用ActivatedTotal)
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: int
         """
         return self._ActivedTotal
@@ -20223,7 +20214,6 @@ class DescribeOrganizationGroupOrganizationsResponse(AbstractModel):
     @property
     def ExportUrl(self):
         """如果入参Export为 true 时使用，表示导出Excel的url
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
         """
         return self._ExportUrl
@@ -20235,7 +20225,6 @@ class DescribeOrganizationGroupOrganizationsResponse(AbstractModel):
     @property
     def List(self):
         """成员企业信息列表
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: list of GroupOrganization
         """
         return self._List
@@ -20247,7 +20236,6 @@ class DescribeOrganizationGroupOrganizationsResponse(AbstractModel):
     @property
     def ActivatedTotal(self):
         """已加入的子企业总数量
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: int
         """
         return self._ActivatedTotal

tencentcloud/lcic/v20220817/models.py

@@ -1268,7 +1268,6 @@ class BatchRegisterResponse(AbstractModel):
     def __init__(self):
         r"""
         :param _Users: 注册成功的用户列表
-注意：此字段可能返回 null，表示取不到有效值。
         :type Users: list of BatchUserInfo
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -1279,7 +1278,6 @@ class BatchRegisterResponse(AbstractModel):
     @property
     def Users(self):
         """注册成功的用户列表
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: list of BatchUserInfo
         """
         return self._Users
@@ -5950,7 +5948,6 @@ class DescribeRoomForbiddenUserResponse(AbstractModel):
     def __init__(self):
         r"""
         :param _MutedAccountList: 禁言用户信息数组，内容包括被禁言的成员 ID，及其被禁言到的时间（使用 UTC 时间，即世界协调时间）
-注意：此字段可能返回 null，表示取不到有效值。
         :type MutedAccountList: list of MutedAccountList
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -5961,7 +5958,6 @@ class DescribeRoomForbiddenUserResponse(AbstractModel):
     @property
     def MutedAccountList(self):
         """禁言用户信息数组，内容包括被禁言的成员 ID，及其被禁言到的时间（使用 UTC 时间，即世界协调时间）
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: list of MutedAccountList
         """
         return self._MutedAccountList
@@ -6888,7 +6884,6 @@ class DescribeScoreListResponse(AbstractModel):
         :param _Total: 总数
         :type Total: int
         :param _Scores: 课堂评分列表
-注意：此字段可能返回 null，表示取不到有效值。
         :type Scores: list of ClassScoreItem
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -6911,7 +6906,6 @@ class DescribeScoreListResponse(AbstractModel):
     @property
     def Scores(self):
         """课堂评分列表
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: list of ClassScoreItem
         """
         return self._Scores
@@ -7019,7 +7013,6 @@ class DescribeSdkAppIdUsersResponse(AbstractModel):
         :param _Total: 用户总数
         :type Total: int
         :param _Users: 当前获取用户信息数组列表
-注意：此字段可能返回 null，表示取不到有效值。
         :type Users: list of UserInfo
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -7042,7 +7035,6 @@ class DescribeSdkAppIdUsersResponse(AbstractModel):
     @property
     def Users(self):
         """当前获取用户信息数组列表
-注意：此字段可能返回 null，表示取不到有效值。
         :rtype: list of UserInfo
         """
         return self._Users