tencentcloud-sdk-python 3.0.1491__py2.py3-none-any.whl → 3.1.6__py2.py3-none-any.whl

tencentcloud/common/http/request_async.py

@@ -0,0 +1,62 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+import httpx
+
+__all__ = ["ApiRequest", "ApiResponse", "RequestPrettyFormatter", "ResponsePrettyFormatter"]
+
+ApiRequest = httpx.Request
+ApiResponse = httpx.Response
+
+
+class RequestPrettyFormatter(object):
+    def __init__(self, req: ApiRequest, format_body=True, delimiter="\n"):
+        self._req = req
+        self._format_body = format_body
+        self._delimiter = delimiter
+
+    def __str__(self):
+        lines = ["%s %s" % (self._req.method, self._req.url)]
+        for k, v in self._req.headers.items():
+            lines.append("%s: %s" % (k, v))
+        lines.append("")
+        if self._format_body:
+            try:
+                lines.append(self._req.content.decode("utf-8"))
+            except UnicodeDecodeError:
+                # binary body
+                import base64
+                lines.append("base64_body:" + base64.standard_b64encode(self._req.content).decode())
+        return self._delimiter.join(lines)
+
+
+class ResponsePrettyFormatter(object):
+    def __init__(self, resp: ApiResponse, format_body=True, delimiter="\n"):
+        self._resp = resp
+        self._format_body = format_body
+        self._delimiter = delimiter
+
+    def __str__(self):
+        lines = ['%s %d %s' % (self.str_ver(self._resp.http_version), self._resp.status_code, self._resp.reason_phrase)]
+        for k, v in self._resp.headers.items():
+            lines.append('%s: %s' % (k, v))
+        return self._delimiter.join(lines)
+
+    async def astr(self):
+        lines = ['%s %d %s' % (self.str_ver(self._resp.http_version), self._resp.status_code, self._resp.reason_phrase)]
+        for k, v in self._resp.headers.items():
+            lines.append('%s: %s' % (k, v))
+        if self._format_body:
+            lines.append('')
+            lines.append((await self._resp.aread()).decode("utf-8"))
+        return self._delimiter.join(lines)
+
+    @staticmethod
+    def str_ver(ver):
+        if ver == 10:
+            return "HTTP/1.0"
+        elif ver == 11:
+            return "HTTP/1.1"
+        elif ver == 20:
+            return "HTTP/2.0"
+        else:
+            return str(ver)

tencentcloud/common/retry_async.py

@@ -0,0 +1,87 @@
+import asyncio
+import logging
+
+import httpx
+
+from tencentcloud.common.exception import TencentCloudSDKException
+
+
+class NoopRetryer(object):
+    """configuration without retry
+
+    NoopRetryer is a retry policy that does nothing.
+    It is useful when you don't want to retry.
+    """
+
+    async def send_request(self, fn):
+        return await fn()
+
+
+class StandardRetryer(object):
+    """Retry configuration
+
+    StandardRetryer is a retry policy that retries on network errors or frequency limitation.
+    :param max_attempts: Maximum number of attempts.
+    :type max_attempts: int
+    :param backoff_fn: A function that takes the number of attempts and returns the number of seconds to sleep before the next retry.
+       Default sleep time is 2^n seconds, n is the number of attempts.
+    :type backoff_fn: function
+    :param logger: A logger to log retry attempts. If not provided, no logging will be performed.
+    :type logger: logging.Logger
+    """
+
+    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
+
+    async def send_request(self, fn):
+        resp = None
+        err = None
+
+        for n in range(self._max_attempts):
+            try:
+                resp = await fn()
+            except TencentCloudSDKException as e:
+                err = e
+            except httpx.TransportError as e:
+                err = e
+
+            if not await self.should_retry(resp, err):
+                if err:
+                    raise err
+                return resp
+
+            sleep = await self._backoff_fn(n)
+            await self.on_retry(n, sleep, resp, err)
+            await asyncio.sleep(sleep)
+
+        raise err
+
+    @staticmethod
+    async def should_retry(resp, err):
+        if not err:
+            return False
+
+        if isinstance(err, httpx.TransportError):
+            return True
+
+        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
+    async def backoff(n):
+        return 2 ** n
+
+    async 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/config/v20220802/config_client_async.py

@@ -0,0 +1,152 @@
+# -*- coding: utf8 -*-
+# Copyright (c) 2017-2025 Tencent. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+
+from tencentcloud.common.abstract_client_async import AbstractClient
+from tencentcloud.config.v20220802 import models
+from typing import Dict
+
+
+class ConfigClient(AbstractClient):
+    _apiVersion = '2022-08-02'
+    _endpoint = 'config.tencentcloudapi.com'
+    _service = 'config'
+
+    async def DescribeAggregateDiscoveredResource(
+            self,
+            request: models.DescribeAggregateDiscoveredResourceRequest,
+            opts: Dict = None,
+    ) -> models.DescribeAggregateDiscoveredResourceResponse:
+        """
+        账号组资源详情
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeAggregateDiscoveredResource"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeAggregateDiscoveredResourceResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeDiscoveredResource(
+            self,
+            request: models.DescribeDiscoveredResourceRequest,
+            opts: Dict = None,
+    ) -> models.DescribeDiscoveredResourceResponse:
+        """
+        资源详情
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeDiscoveredResource"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeDiscoveredResourceResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def ListAggregateConfigRules(
+            self,
+            request: models.ListAggregateConfigRulesRequest,
+            opts: Dict = None,
+    ) -> models.ListAggregateConfigRulesResponse:
+        """
+        账号组获取规则列表
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "ListAggregateConfigRules"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.ListAggregateConfigRulesResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def ListAggregateDiscoveredResources(
+            self,
+            request: models.ListAggregateDiscoveredResourcesRequest,
+            opts: Dict = None,
+    ) -> models.ListAggregateDiscoveredResourcesResponse:
+        """
+        账号组获取资源列表
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "ListAggregateDiscoveredResources"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.ListAggregateDiscoveredResourcesResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def ListConfigRules(
+            self,
+            request: models.ListConfigRulesRequest,
+            opts: Dict = None,
+    ) -> models.ListConfigRulesResponse:
+        """
+        获取规则列表
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "ListConfigRules"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.ListConfigRulesResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def ListDiscoveredResources(
+            self,
+            request: models.ListDiscoveredResourcesRequest,
+            opts: Dict = None,
+    ) -> models.ListDiscoveredResourcesResponse:
+        """
+        获取资源列表
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "ListDiscoveredResources"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.ListDiscoveredResourcesResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def PutEvaluations(
+            self,
+            request: models.PutEvaluationsRequest,
+            opts: Dict = None,
+    ) -> models.PutEvaluationsResponse:
+        """
+        上报自定义规则评估结果
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "PutEvaluations"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.PutEvaluationsResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)

tencentcloud/controlcenter/v20230110/controlcenter_client_async.py

@@ -0,0 +1,116 @@
+# -*- coding: utf8 -*-
+# Copyright (c) 2017-2025 Tencent. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+
+from tencentcloud.common.abstract_client_async import AbstractClient
+from tencentcloud.controlcenter.v20230110 import models
+from typing import Dict
+
+
+class ControlcenterClient(AbstractClient):
+    _apiVersion = '2023-01-10'
+    _endpoint = 'controlcenter.tencentcloudapi.com'
+    _service = 'controlcenter'
+
+    async def BatchApplyAccountBaselines(
+            self,
+            request: models.BatchApplyAccountBaselinesRequest,
+            opts: Dict = None,
+    ) -> models.BatchApplyAccountBaselinesResponse:
+        """
+        批量对存量账号应用基线
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "BatchApplyAccountBaselines"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.BatchApplyAccountBaselinesResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def GetAccountFactoryBaseline(
+            self,
+            request: models.GetAccountFactoryBaselineRequest,
+            opts: Dict = None,
+    ) -> models.GetAccountFactoryBaselineResponse:
+        """
+        获取用户基线配置数据
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "GetAccountFactoryBaseline"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.GetAccountFactoryBaselineResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def ListAccountFactoryBaselineItems(
+            self,
+            request: models.ListAccountFactoryBaselineItemsRequest,
+            opts: Dict = None,
+    ) -> models.ListAccountFactoryBaselineItemsResponse:
+        """
+        获取账号工厂系统基线项
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "ListAccountFactoryBaselineItems"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.ListAccountFactoryBaselineItemsResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def ListDeployStepTasks(
+            self,
+            request: models.ListDeployStepTasksRequest,
+            opts: Dict = None,
+    ) -> models.ListDeployStepTasksResponse:
+        """
+        获取某个基线项历史应用信息
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "ListDeployStepTasks"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.ListDeployStepTasksResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def UpdateAccountFactoryBaseline(
+            self,
+            request: models.UpdateAccountFactoryBaselineRequest,
+            opts: Dict = None,
+    ) -> models.UpdateAccountFactoryBaselineResponse:
+        """
+        更新用户当前基线项配置，基线配置会覆盖更新为当前配置。新增基线项时需要将新增的基线配置加到现有配置，删除基线项时需要将删除的基线配置从现有配置移除，然后保存最新基线配置。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "UpdateAccountFactoryBaseline"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.UpdateAccountFactoryBaselineResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)