tencentcloud-sdk-python 3.0.1373__py2.py3-none-any.whl → 3.0.1375__py2.py3-none-any.whl

tencentcloud/clb/v20180317/clb_client.py

@@ -74,7 +74,11 @@ class ClbClient(AbstractClient):
 
     def AssociateTargetGroups(self, request):
         """本接口(AssociateTargetGroups)用来将目标组绑定到负载均衡的监听器（四层协议）或转发规则（七层协议）上。
-        本接口为异步接口，本接口返回成功后需以返回的 RequestID 为入参，调用 DescribeTaskStatus 接口查询本次任务是否成功。
+        本接口为异步接口，本接口返回成功后需以返回的 RequestID 为入参，调用  [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683)  接口查询本次任务是否成功。
+        限制说明：
+        - 四层监听器绑定旧版目标组需要监听器开启后端目标组。
+        - 七层绑定目标组，数据结构 TargetGroupAssosication 中 LocationId 为必填项。
+        - 负载均衡的 VPC 需要和目标组的 VPC 一致。
 
         :param request: Request instance for AssociateTargetGroups.
         :type request: :class:`tencentcloud.clb.v20180317.models.AssociateTargetGroupsRequest`
@@ -219,8 +223,8 @@ class ClbClient(AbstractClient):
 
         限制说明
         实例属性维度限制：
-        - 支持克隆网络计费模式为按量计费与包年包月的实例，包年包月实例克隆后的新实例网络计费模式会转换为按小时带宽计费，其带宽、规格与原实例设置保持一致。
-        - 不支持克隆未关联实例计费项的 CLB。
+        - 支持克隆实例计费模式为按量计费与包年包月的实例，包年包月实例克隆后的新实例网络计费模式会转换为按小时带宽计费，其带宽、规格与原实例设置保持一致。
+        - 不支持克隆未关联实例计费项的 CLB（历史免费活动创建）。
         - 不支持克隆传统型负载均衡实例和高防 CLB。
         - 不支持克隆基础网络类型的实例。
         - 不支持克隆 Anycast 类型的实例。
@@ -280,7 +284,7 @@ class ClbClient(AbstractClient):
 
     def CreateListener(self, request):
         """在一个负载均衡实例下创建监听器。
-        本接口为异步接口，接口返回成功后，需以返回的 RequestId 为入参，调用 DescribeTaskStatus 接口查询本次任务是否成功。
+        本接口为异步接口，接口返回成功后，需以返回的 RequestId 为入参，调用 [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683) 接口查询本次任务是否成功。
 
         :param request: Request instance for CreateListener.
         :type request: :class:`tencentcloud.clb.v20180317.models.CreateListenerRequest`
@@ -305,7 +309,7 @@ class ClbClient(AbstractClient):
     def CreateLoadBalancer(self, request):
         """本接口(CreateLoadBalancer)用来创建负载均衡实例。为了使用负载均衡服务，您必须购买一个或多个负载均衡实例。成功调用该接口后，会返回负载均衡实例的唯一 ID。负载均衡实例的类型分为：公网、内网。详情可参考产品说明中的产品类型。
         注意：(1)可通过 [DescribeResources](https://cloud.tencent.com/document/api/214/70213) 接口查询一个地域是否支持创建IPv6实例；(2)一个账号在每个地域的默认购买配额为：公网100个，内网100个。
-        本接口为异步接口，接口成功返回后，可使用 DescribeLoadBalancers 接口查询负载均衡实例的状态（如创建中、正常），以确定是否创建成功。
+        本接口为异步接口，接口成功返回后，可使用 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/1108/48459) 接口查询负载均衡实例的状态（如创建中、正常），以确定是否创建成功。
 
         :param request: Request instance for CreateLoadBalancer.
         :type request: :class:`tencentcloud.clb.v20180317.models.CreateLoadBalancerRequest`
@@ -329,7 +333,7 @@ class ClbClient(AbstractClient):
 
     def CreateLoadBalancerSnatIps(self, request):
         """针对SnatPro负载均衡，这个接口用于添加SnatIp，如果负载均衡没有开启SnatPro，添加SnatIp后会自动开启。
-        本接口为异步接口，接口返回成功后，需以得到的 RequestID 为入参，调用 DescribeTaskStatus 接口查询本次任务是否成功。
+        本接口为异步接口，接口返回成功后，需以得到的 RequestID 为入参，调用  [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683)  接口查询本次任务是否成功。
 
         :param request: Request instance for CreateLoadBalancerSnatIps.
         :type request: :class:`tencentcloud.clb.v20180317.models.CreateLoadBalancerSnatIpsRequest`
@@ -353,7 +357,7 @@ class ClbClient(AbstractClient):
 
     def CreateRule(self, request):
         """CreateRule 接口用于在一个已存在的负载均衡七层监听器下创建转发规则，七层监听器中，后端服务必须绑定到规则上而非监听器上。
-        本接口为异步接口，本接口返回成功后需以返回的RequestID为入参，调用DescribeTaskStatus接口查询本次任务是否成功。
+        本接口为异步接口，本接口返回成功后需以返回的RequestID为入参，调用 [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683) 接口查询本次任务是否成功。
 
         :param request: Request instance for CreateRule.
         :type request: :class:`tencentcloud.clb.v20180317.models.CreateRuleRequest`
@@ -446,7 +450,7 @@ class ClbClient(AbstractClient):
 
     def DeleteListener(self, request):
         """本接口用来删除负载均衡实例下的监听器（四层和七层）。
-        本接口为异步接口，接口返回成功后，需以得到的 RequestID 为入参，调用 DescribeTaskStatus 接口查询本次任务是否成功。
+        本接口为异步接口，接口返回成功后，需以得到的 RequestID 为入参，调用  [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683)  接口查询本次任务是否成功。
 
         :param request: Request instance for DeleteListener.
         :type request: :class:`tencentcloud.clb.v20180317.models.DeleteListenerRequest`
@@ -470,7 +474,7 @@ class ClbClient(AbstractClient):
 
     def DeleteLoadBalancer(self, request):
         """DeleteLoadBalancer 接口用以删除指定的一个或多个负载均衡实例。成功删除后，会把负载均衡实例下的监听器、转发规则一起删除，并把后端服务解绑。
-        本接口为异步接口，接口返回成功后，需以返回的 RequestId 为入参，调用 DescribeTaskStatus 接口查询本次任务是否成功。
+        本接口为异步接口，接口返回成功后，需以返回的 RequestId 为入参，调用 [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683) 接口查询本次任务是否成功。
 
         :param request: Request instance for DeleteLoadBalancer.
         :type request: :class:`tencentcloud.clb.v20180317.models.DeleteLoadBalancerRequest`
@@ -494,7 +498,7 @@ class ClbClient(AbstractClient):
 
     def DeleteLoadBalancerListeners(self, request):
         """该接口支持删除负载均衡的多个监听器。
-        本接口为异步接口，本接口返回成功后需以返回的 RequestID 为入参，调用 DescribeTaskStatus 接口查询本次任务是否成功。
+        本接口为异步接口，本接口返回成功后需以返回的 RequestID 为入参，调用  [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683)  接口查询本次任务是否成功。
 
         :param request: Request instance for DeleteLoadBalancerListeners.
         :type request: :class:`tencentcloud.clb.v20180317.models.DeleteLoadBalancerListenersRequest`
@@ -518,7 +522,7 @@ class ClbClient(AbstractClient):
 
     def DeleteLoadBalancerSnatIps(self, request):
         """这个接口用于删除SnatPro的负载均衡的SnatIp。
-        本接口为异步接口，接口返回成功后，需以得到的 RequestID 为入参，调用 DescribeTaskStatus 接口查询本次任务是否成功。
+        本接口为异步接口，接口返回成功后，需以得到的 RequestID 为入参，调用  [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683)  接口查询本次任务是否成功。
 
         :param request: Request instance for DeleteLoadBalancerSnatIps.
         :type request: :class:`tencentcloud.clb.v20180317.models.DeleteLoadBalancerSnatIpsRequest`
@@ -566,7 +570,7 @@ class ClbClient(AbstractClient):
 
     def DeleteRule(self, request):
         """DeleteRule 接口用来删除负载均衡实例七层监听器下的转发规则。
-        本接口为异步接口，本接口返回成功后需以返回的RequestID为入参，调用DescribeTaskStatus接口查询本次任务是否成功。
+        本接口为异步接口，本接口返回成功后需以返回的RequestID为入参，调用  [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683)  接口查询本次任务是否成功。
 
         :param request: Request instance for DeleteRule.
         :type request: :class:`tencentcloud.clb.v20180317.models.DeleteRuleRequest`
@@ -589,7 +593,7 @@ class ClbClient(AbstractClient):
 
 
     def DeleteTargetGroups(self, request):
-        """删除目标组
+        """删除目标组，支持批量删除目标组，单次最多批量删除 20 个目标组。
 
         :param request: Request instance for DeleteTargetGroups.
         :type request: :class:`tencentcloud.clb.v20180317.models.DeleteTargetGroupsRequest`
@@ -1409,6 +1413,7 @@ class ClbClient(AbstractClient):
     def DisassociateTargetGroups(self, request):
         """解除规则的目标组关联关系。
         本接口为异步接口，本接口返回成功后需以返回的 RequestID 为入参，调用 DescribeTaskStatus 接口查询本次任务是否成功。
+        当解绑七层转发规则时，LocationId 为必填项。
 
         :param request: Request instance for DisassociateTargetGroups.
         :type request: :class:`tencentcloud.clb.v20180317.models.DisassociateTargetGroupsRequest`
@@ -1477,7 +1482,7 @@ class ClbClient(AbstractClient):
 
 
     def InquiryPriceRefundLoadBalancer(self, request):
-        """InquiryPriceRefundLoadBalancer接口查询负载均衡退费价格。
+        """InquiryPriceRefundLoadBalancer接口查询负载均衡退费价格，只支持预付费类型的负载均衡实例。
 
         :param request: Request instance for InquiryPriceRefundLoadBalancer.
         :type request: :class:`tencentcloud.clb.v20180317.models.InquiryPriceRefundLoadBalancerRequest`
@@ -1619,7 +1624,7 @@ class ClbClient(AbstractClient):
 
     def ModifyDomain(self, request):
         """ModifyDomain接口用来修改负载均衡七层监听器下的域名。
-        本接口为异步接口，本接口返回成功后需以返回的RequestID为入参，调用DescribeTaskStatus接口查询本次任务是否成功。
+        本接口为异步接口，本接口返回成功后需以返回的RequestID为入参，调用 [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683) 接口查询本次任务是否成功。
 
         :param request: Request instance for ModifyDomain.
         :type request: :class:`tencentcloud.clb.v20180317.models.ModifyDomainRequest`
@@ -1642,8 +1647,8 @@ class ClbClient(AbstractClient):
 
 
     def ModifyDomainAttributes(self, request):
-        """ModifyDomainAttributes接口用于修改负载均衡7层监听器转发规则的域名级别属性，如修改域名、修改DefaultServer、开启/关闭Http2、修改证书。
-        本接口为异步接口，本接口返回成功后，需以返回的RequestId为入参，调用DescribeTaskStatus接口查询本次任务是否成功。
+        """ModifyDomainAttributes接口用于修改负载均衡7层监听器转发规则的域名级别属性，如修改域名、修改DefaultServer、开启/关闭Http2、修改证书
+        本接口为异步接口，本接口返回成功后，需以返回的RequestId为入参，调用 [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683) 接口查询本次任务是否成功。
 
         :param request: Request instance for ModifyDomainAttributes.
         :type request: :class:`tencentcloud.clb.v20180317.models.ModifyDomainAttributesRequest`
@@ -1667,6 +1672,8 @@ class ClbClient(AbstractClient):
 
     def ModifyFunctionTargets(self, request):
         """修改负载均衡转发规则上所绑定的云函数。
+        限制说明：
+        - 仅支持绑定“Event 函数”类型的云函数。
 
         :param request: Request instance for ModifyFunctionTargets.
         :type request: :class:`tencentcloud.clb.v20180317.models.ModifyFunctionTargetsRequest`
@@ -1690,7 +1697,7 @@ class ClbClient(AbstractClient):
 
     def ModifyListener(self, request):
         """ModifyListener接口用来修改负载均衡监听器的属性，包括监听器名称、健康检查参数、证书信息、转发策略等。本接口不支持传统型负载均衡。
-        本接口为异步接口，本接口返回成功后需以返回的RequestID为入参，调用DescribeTaskStatus接口查询本次任务是否成功。
+        本接口为异步接口，本接口返回成功后需以返回的RequestID为入参，调用 [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683) 接口查询本次任务是否成功。
 
         :param request: Request instance for ModifyListener.
         :type request: :class:`tencentcloud.clb.v20180317.models.ModifyListenerRequest`
@@ -1715,7 +1722,7 @@ class ClbClient(AbstractClient):
     def ModifyLoadBalancerAttributes(self, request):
         """修改负载均衡实例的属性。支持修改负载均衡实例的名称、设置负载均衡的跨域属性。
         注意：非带宽上移用户的 CLB 实例必须加入带宽包才可以设置跨域属性。
-        本接口为异步接口，接口返回成功后，需以得到的 RequestID 为入参，调用 DescribeTaskStatus 接口查询本次任务是否成功。
+        本接口为异步接口，接口返回成功后，需以得到的 RequestID 为入参，调用 [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683) 接口查询本次任务是否成功。
 
         :param request: Request instance for ModifyLoadBalancerAttributes.
         :type request: :class:`tencentcloud.clb.v20180317.models.ModifyLoadBalancerAttributesRequest`
@@ -1812,7 +1819,7 @@ class ClbClient(AbstractClient):
 
     def ModifyRule(self, request):
         """ModifyRule 接口用来修改负载均衡七层监听器下的转发规则的各项属性，包括转发路径、健康检查属性、转发策略等。
-        本接口为异步接口，本接口返回成功后需以返回的RequestID为入参，调用DescribeTaskStatus接口查询本次任务是否成功。
+        本接口为异步接口，本接口返回成功后需以返回的RequestID为入参，调用 [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683) 接口查询本次任务是否成功。
 
         :param request: Request instance for ModifyRule.
         :type request: :class:`tencentcloud.clb.v20180317.models.ModifyRuleRequest`
@@ -1965,6 +1972,7 @@ class ClbClient(AbstractClient):
         - 目前仅 IPv4、IPv6 NAT64 版本的负载均衡支持绑定 SCF，IPv6 版本的暂不支持。
         - 仅七层（HTTP、HTTPS）监听器支持绑定 SCF，四层（TCP、UDP、TCP SSL）监听器和七层 QUIC 监听器不支持。
         - CLB 绑定 SCF 仅支持绑定“Event 函数”类型的云函数。
+        - 一个转发规则只支持绑定一个云函数。
 
         :param request: Request instance for RegisterFunctionTargets.
         :type request: :class:`tencentcloud.clb.v20180317.models.RegisterFunctionTargetsRequest`
@@ -2012,7 +2020,7 @@ class ClbClient(AbstractClient):
 
     def RegisterTargets(self, request):
         """RegisterTargets 接口用来将一台或多台后端服务绑定到负载均衡的监听器（或7层转发规则），在此之前您需要先行创建相关的4层监听器或7层转发规则。对于四层监听器（TCP、UDP），只需指定监听器ID即可，对于七层监听器（HTTP、HTTPS），还需通过LocationId或者Domain+Url指定转发规则。
-        本接口为异步接口，本接口返回成功后需以返回的RequestID为入参，调用DescribeTaskStatus接口查询本次任务是否成功。
+        本接口为异步接口，本接口返回成功后需以返回的RequestID为入参，调用  [DescribeTaskStatus](https://cloud.tencent.com/document/product/214/30683)  接口查询本次任务是否成功。
 
         :param request: Request instance for RegisterTargets.
         :type request: :class:`tencentcloud.clb.v20180317.models.RegisterTargetsRequest`
@@ -2130,7 +2138,7 @@ class ClbClient(AbstractClient):
 
 
     def SetLoadBalancerSecurityGroups(self, request):
-        """SetLoadBalancerSecurityGroups 接口支持对一个公网负载均衡实例执行设置（绑定、解绑）安全组操作。查询一个负载均衡实例目前已绑定的安全组，可使用 DescribeLoadBalancers 接口。本接口是set语义，
+        """SetLoadBalancerSecurityGroups 接口支持对一个公网负载均衡实例执行设置（绑定、解绑）安全组操作。查询一个负载均衡实例目前已绑定的安全组，可使用 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/1108/48459) 接口。本接口是set语义，
         绑定操作时，入参需要传入负载均衡实例要绑定的所有安全组（已绑定的+新增绑定的）。
         解绑操作时，入参需要传入负载均衡实例执行解绑后所绑定的所有安全组；如果要解绑所有安全组，可不传此参数，或传入空数组。注意：内网 CLB 绑定 EIP 后，CLB 上的安全组对来自 EIP 的流量不生效，对来自内网 CLB 的流量生效。
 
@@ -2180,7 +2188,7 @@ class ClbClient(AbstractClient):
 
 
     def SetSecurityGroupForLoadbalancers(self, request):
-        """绑定或解绑一个安全组到多个公网负载均衡实例。注意：内网负载均衡不支持绑定安全组。
+        """绑定或解绑一个安全组到多个公网负载均衡实例。
 
         :param request: Request instance for SetSecurityGroupForLoadbalancers.
         :type request: :class:`tencentcloud.clb.v20180317.models.SetSecurityGroupForLoadbalancersRequest`

tencentcloud/clb/v20180317/errorcodes.py

@@ -32,6 +32,9 @@ FAILEDOPERATION_INVALIDLBSTATUS = 'FailedOperation.InvalidLBStatus'
 # 没有监听器的实例不允许停止。
 FAILEDOPERATION_NOLISTENERINLB = 'FailedOperation.NoListenerInLB'
 
+# 指定的资源正在克隆中，请稍后重试。
+FAILEDOPERATION_RESOURCEINCLONING = 'FailedOperation.ResourceInCloning'
+
 # 正在操作指定的资源，请稍后重试。
 FAILEDOPERATION_RESOURCEINOPERATING = 'FailedOperation.ResourceInOperating'