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

tencentcloud/sts/v20180813/sts_client_async.py

@@ -0,0 +1,205 @@
+# -*- 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.sts.v20180813 import models
+from typing import Dict
+
+
+class StsClient(AbstractClient):
+    _apiVersion = '2018-08-13'
+    _endpoint = 'sts.tencentcloudapi.com'
+    _service = 'sts'
+
+    async def AssumeRole(
+            self,
+            request: models.AssumeRoleRequest,
+            opts: Dict = None,
+    ) -> models.AssumeRoleResponse:
+        """
+        **使用说明**
+
+        1. 申请扮演某个角色的临时访问凭证，返回临时身份的token和能够扮演该角色的临时密钥；
+        2. 角色策略组成
+        （1）角色载体：指定谁可以扮演该角色；
+        （2）角色权限：指定扮演角色后可以执行哪些操作，操作哪些资源。
+
+        3. 角色可被扮演的条件
+        （1）给该用户绑定包含AssumeRole的策略；
+        （2）将该用户配置为角色载体的主体。
+
+        4. 此接口可以支持永久密钥或临时密钥调用。
+
+
+        **典型场景**
+
+        1. 跨账号授权：主账号A需要操作主账号B的资源。
+        例如：A账号下有子用户a，B账号下有角色role b，a可以通过AssumeRole接口扮演b，以角色b身份登录账号B的控制台，并操作资源。
+
+        2. 跨服务调用：云上的A服务需要访问或操作B服务的资源。
+        例如：为A服务接入一个服务相关角色，用户授权创建角色和策略后，A服务即可调用AssumeRole获取用户的服务相关角色临时密钥，调用B服务接口并访问资源。
+
+
+
+        **最佳实践**
+        1. 临时访问凭证在有效期内（Expiration）都可以使用，建议在有效期内重复使用，避免业务请求该接口频率达到上限被限频；
+        2. 授予临时访问凭证权限的CAM策略，建议严格遵循最小权限原则；
+        3. 建议不要使用主账号永久密钥，对该接口进行调用。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "AssumeRole"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.AssumeRoleResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def AssumeRoleWithSAML(
+            self,
+            request: models.AssumeRoleWithSAMLRequest,
+            opts: Dict = None,
+    ) -> models.AssumeRoleWithSAMLResponse:
+        """
+        本接口（AssumeRoleWithSAML）用于根据 SAML 断言申请角色临时访问凭证。
+
+        注意：当使用签名方法 V3 调用本接口时，请求头无须传入 X-TC-Token, 但 Authorization 需要传入值 SKIP。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "AssumeRoleWithSAML"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.AssumeRoleWithSAMLResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def AssumeRoleWithWebIdentity(
+            self,
+            request: models.AssumeRoleWithWebIdentityRequest,
+            opts: Dict = None,
+    ) -> models.AssumeRoleWithWebIdentityResponse:
+        """
+        申请OIDC角色临时访问凭证。
+
+        注意：当使用签名方法 V3 调用本接口时，请求头无须传入 X-TC-Token, 但 Authorization 需要传入值 SKIP。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "AssumeRoleWithWebIdentity"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.AssumeRoleWithWebIdentityResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def GetCallerIdentity(
+            self,
+            request: models.GetCallerIdentityRequest,
+            opts: Dict = None,
+    ) -> models.GetCallerIdentityResponse:
+        """
+        获取当前调用者的身份信息。
+
+        接口支持主账号，子账号长期密钥以及AssumeRole，GetFederationToken生成的临时访问凭证身份获取。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "GetCallerIdentity"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.GetCallerIdentityResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def GetFederationToken(
+            self,
+            request: models.GetFederationTokenRequest,
+            opts: Dict = None,
+    ) -> models.GetFederationTokenResponse:
+        """
+        **使用说明**
+
+        1. 返回一组临时身份访问凭证，包含token和获取该身份的临时密钥；
+
+        2. 当您需要将当前账号下的部分权限和资源临时委托给第三方（如合作伙伴、外包团队），且希望避免下发永久密钥时，调用此接口；
+        3. 临时身份的权限为：当前调用账号的权限和输入参数 Policy 权限的交集；
+        4. 此接口仅支持永久密钥调用。
+
+
+        **典型场景**
+
+        1. 代理应用程序集中申请临时访问凭证，下发给企业网络内的其他分布式终端应用。例如：终端应用上传文件到COS。
+
+        2. 将指定资源临时委托给第三方代理。例如：申请临时访问凭证，分发给企业外部团队，仅允许查看某个存储桶，有效期结束后权限自动回收。
+
+
+        **最佳实践**
+        1. 临时访问凭证在有效期内（Expiration）都可以使用，建议在有效期内重复使用，避免业务请求该接口频率达到上限被限频；
+
+        2. 授予临时访问凭证权限的CAM策略，建议严格遵循最小权限原则；
+        3. 建议不要使用主账号永久密钥，对该接口进行调用。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "GetFederationToken"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.GetFederationTokenResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def GetSessionToken(
+            self,
+            request: models.GetSessionTokenRequest,
+            opts: Dict = None,
+    ) -> models.GetSessionTokenResponse:
+        """
+        获取MFA临时证书
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "GetSessionToken"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.GetSessionTokenResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def QueryApiKey(
+            self,
+            request: models.QueryApiKeyRequest,
+            opts: Dict = None,
+    ) -> models.QueryApiKeyResponse:
+        """
+        拉取API密钥列表
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "QueryApiKey"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.QueryApiKeyResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)

tencentcloud/svp/v20240125/svp_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.svp.v20240125 import models
+from typing import Dict
+
+
+class SvpClient(AbstractClient):
+    _apiVersion = '2024-01-25'
+    _endpoint = 'svp.tencentcloudapi.com'
+    _service = 'svp'
+
+    async def CreateSavingPlanOrder(
+            self,
+            request: models.CreateSavingPlanOrderRequest,
+            opts: Dict = None,
+    ) -> models.CreateSavingPlanOrderResponse:
+        """
+        创建节省计划订单
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "CreateSavingPlanOrder"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.CreateSavingPlanOrderResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeSavingPlanCoverage(
+            self,
+            request: models.DescribeSavingPlanCoverageRequest,
+            opts: Dict = None,
+    ) -> models.DescribeSavingPlanCoverageResponse:
+        """
+        查询当前用户节省计划覆盖率明细数据，如无特别说明，金额单位均为元（国内站）或者美元（国际站）。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeSavingPlanCoverage"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeSavingPlanCoverageResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeSavingPlanDeduct(
+            self,
+            request: models.DescribeSavingPlanDeductRequest,
+            opts: Dict = None,
+    ) -> models.DescribeSavingPlanDeductResponse:
+        """
+        查询节省计划抵扣明细
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeSavingPlanDeduct"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeSavingPlanDeductResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeSavingPlanOverview(
+            self,
+            request: models.DescribeSavingPlanOverviewRequest,
+            opts: Dict = None,
+    ) -> models.DescribeSavingPlanOverviewResponse:
+        """
+        查用当前用户明细节省计划总览查询时段内的使用情况
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeSavingPlanOverview"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeSavingPlanOverviewResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeSavingPlanUsage(
+            self,
+            request: models.DescribeSavingPlanUsageRequest,
+            opts: Dict = None,
+    ) -> models.DescribeSavingPlanUsageResponse:
+        """
+        查用当前用户明细节省计划查询时段内的使用情况
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeSavingPlanUsage"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeSavingPlanUsageResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)

tencentcloud/taf/v20200210/taf_client_async.py

@@ -0,0 +1,44 @@
+# -*- 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.taf.v20200210 import models
+from typing import Dict
+
+
+class TafClient(AbstractClient):
+    _apiVersion = '2020-02-10'
+    _endpoint = 'taf.tencentcloudapi.com'
+    _service = 'taf'
+
+    async def ManagePortraitRisk(
+            self,
+            request: models.ManagePortraitRiskRequest,
+            opts: Dict = None,
+    ) -> models.ManagePortraitRiskResponse:
+        """
+        虚假流量识别
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "ManagePortraitRisk"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.ManagePortraitRiskResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)