Merge "integration_2025-04-28_881197335810" into "vod-Python-2025-01-01-online-1109-2025_04_15_14_41_25"

Conflicts:
meta.json
setup.py
volcenginesdkcore/api_client.py
volcenginesdkcore/configuration.py

Author: bytestarter

FAQ.md

@@ -1,6 +1,8 @@
 ### 1. 获取请求和响应类型
+
 在方法调用前，通过 param 和 return 获取请求和响应对应的结构体  
 以 ecs.run_instances 为例
+
 ```python
 def run_instances(self, body, **kwargs):  # noqa: E501
     """run_instances
@@ -9,10 +11,11 @@ def run_instances(self, body, **kwargs):  # noqa: E501
     """
 ```
 
-
 ### 2. 获取请求和响应的参数类型
+
 在 Request 或者 Response 请求体中，通过 swagger_types 查看具体的请求参数和类型  
 以 volcenginesdkecs.RunInstancesRequest 为例，其参数名称和定义如下所示
+
 ```python
 swagger_types = {
     'auto_renew': 'bool',
@@ -25,7 +28,9 @@ swagger_types = {
     ......
 }
 ```
+
 对应的请求体为
+
 ```python
 volcenginesdkecs.RunInstancesRequest(
     instance_name="insname",
@@ -42,10 +47,13 @@ volcenginesdkecs.RunInstancesRequest(
     instance_charge_type="PostPaid"
 )
 ```
+
 ### 3. 出现内存溢出
+
 检查 Configuration._default 是否被初始化  
 如果没有初始化，每一次创建 Configuration 的时候，会创建新的 logger handler 并加入到全局的 logger 中  
 建议通过 Configuration.set_default 方法对 Configuration 进行赋值
+
 ```python
 configuration = volcenginesdkcore.Configuration()
 configuration.client_side_validation = False
@@ -56,7 +64,34 @@ volcenginesdkcore.Configuration.set_default(configuration)
 ```
 
 ### 4. 对象转 Dict
+
 对于请求和响应的对象，可以通过 to_dict() 方法将其转换成 dict 类型
 
 ### 5. 查看使用示例
+
 [volcenginesdkexamples](https://github.com/volcengine/volcengine-python-sdk/tree/master/volcenginesdkexamples)
+
+### 6. 响应对象转驼峰风格 Dict
+
+在实际调用 API 后，所接收的响应对象参数通常采用首字母大写的驼峰命名法。而在使用 Python SDK 进行编码时，由于 Python
+的整体命名规范为下划线命名法，当使用响应参数并对照文档时，您可能想要在 Python SDK 所采用的下划线命名法与文档中的驼峰命名法之间进行转换。
+
+当然，可通过调用以下代码将响应对象转换为驼峰格式的字典，转换后字典中的字段名与文档中的字段名完全一致
+
+```python
+import json
+import pprint
+from volcenginesdkcore.model import canonical_str
+
+try:
+    resp = api_instance.list_users(req)
+    pprint(resp)  # 字段为下划线的响应对象
+    dict_resp = json.loads(json.dumps(canonical_str(resp)))
+    pprint(dict_resp)  # 字段为驼峰的响应字典
+
+except ApiException as e:
+    print("Exception when calling IAMApi->ListUsers: %s\n" % e)
+
+```
+
+不过，这种方法并非推荐的使用方式。建议直接使用响应对象中以下划线命名的参数，而非进行上述转换后使用。 

README.md

@@ -11,6 +11,7 @@
 
 * Python版本需要不低于2.7。
 * 由于 Windows 系统有最长路径限制，可能会导致安装失败，请按照以下方式设置：
+
 ```
 1. 按下 Win+R ，输入 regedit 打开注册表编辑器。
 2. 设置 \HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem 路径下的变量 LongPathsEnabled 为 1 即可。
@@ -19,6 +20,7 @@
 ### Install ###
 
 Install via pip
+
 ```sh
 pip install volcengine-python-sdk
 ```
@@ -31,7 +33,54 @@ python setup.py install --user
 
 (or `sudo python setup.py install` to install the package for all users)
 
-### Basic Usage ###
+### Configuration Usage ###
+
+步骤一：启动时初始化，配置 Configuration 全局默认参数
+
+```python
+configuration = volcenginesdkcore.Configuration()
+configuration.client_side_validation = True  # 客户端是否进行参数校验
+configuration.schema = "http"  # https or http
+configuration.debug = False  # 是否开启调试
+configuration.logger_file = "sdk.log"
+
+volcenginesdkcore.Configuration.set_default(configuration)
+```
+
+步骤二：获取 Client
+
+```python
+def get_client(ak, sk, region):
+    # 包含默认属性
+    configuration = volcenginesdkcore.Configuration()
+    configuration.ak = ak
+    configuration.sk = sk
+    configuration.region = region
+    client = volcenginesdkautoscaling.AUTOSCALINGApi(volcenginesdkcore.ApiClient(configuration))
+    return client
+```
+
+### Endpoint 设置 ###
+
+如果您要自定义SDK的Endpoint，可以按照以下示例代码设置：
+
+```python
+configuration = volcenginesdkcore.Configuration()
+configuration.host = 'ecs.cn-beijing-autodriving.volcengineapi.com'
+```
+
+火山引擎标准的Endpoint规则说明：
+
+| Regional 服务                                                                                                                            | Global 服务                                                                          |
+|----------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------|
+| `{service}.{region}.volcengineapi.com` <br> 例如：云服务ecs在cn-beijing-autodriving Region域名为： `ecs.cn-beijing-autodriving.volcengineapi.com` | `{service}.volcengineapi.com` <br> 例如：访问控制iam为Global服务，域名为：`iam.volcengineapi.com` |
+
+注：
+
+- Service中存在_符号时，Endpoint时需转为-符号。存在大写字母时需转成小写。
+- 并非所有云产品和Region都支持标准域名，具体请前往您所使用的产品-API参考中查看。
+
+### SDK 示例 ###
 
 ```python
 from __future__ import print_function
@@ -77,27 +126,7 @@ if __name__ == '__main__':
         print("Exception when calling ECSApi->run_instances: %s\n" % e)
 
 ```
-### Configuration Usage ###
-步骤一：启动时初始化，配置 Configuration 全局默认参数
-```python
-configuration = volcenginesdkcore.Configuration()
-configuration.client_side_validation = True  # 客户端是否进行参数校验
-configuration.schema = "http"  # https or http
-configuration.debug = False  # 是否开启调试
-configuration.logger_file = "sdk.log"
 
-volcenginesdkcore.Configuration.set_default(configuration)
-```
-步骤二：获取 Client
-```python
-def get_client(ak, sk, region):
-    # 包含默认属性
-    configuration = volcenginesdkcore.Configuration()
-    configuration.ak = ak
-    configuration.sk = sk
-    configuration.region = region
-    client = volcenginesdkautoscaling.AUTOSCALINGApi(volcenginesdkcore.ApiClient(configuration))
-    return client
-```
 ### FAQ ###
+
 关于 SDK 使用时碰到的常见问题，请查看 [FAQ](FAQ.md)

volcenginesdkalb/__init__.py

@@ -95,6 +95,8 @@
 from volcenginesdkalb.models.describe_rules_response import DescribeRulesResponse
 from volcenginesdkalb.models.describe_server_group_attributes_request import DescribeServerGroupAttributesRequest
 from volcenginesdkalb.models.describe_server_group_attributes_response import DescribeServerGroupAttributesResponse
+from volcenginesdkalb.models.describe_server_group_backend_servers_request import DescribeServerGroupBackendServersRequest
+from volcenginesdkalb.models.describe_server_group_backend_servers_response import DescribeServerGroupBackendServersResponse
 from volcenginesdkalb.models.describe_server_groups_request import DescribeServerGroupsRequest
 from volcenginesdkalb.models.describe_server_groups_response import DescribeServerGroupsResponse
 from volcenginesdkalb.models.describe_zones_request import DescribeZonesRequest
@@ -133,6 +135,7 @@
 from volcenginesdkalb.models.health_check_template_for_create_health_check_templates_input import HealthCheckTemplateForCreateHealthCheckTemplatesInput
 from volcenginesdkalb.models.health_check_template_for_describe_health_check_templates_output import HealthCheckTemplateForDescribeHealthCheckTemplatesOutput
 from volcenginesdkalb.models.health_check_template_for_modify_health_check_templates_attributes_input import HealthCheckTemplateForModifyHealthCheckTemplatesAttributesInput
+from volcenginesdkalb.models.health_check_templates_tag_for_create_health_check_templates_input import HealthCheckTemplatesTagForCreateHealthCheckTemplatesInput
 from volcenginesdkalb.models.health_log_for_describe_load_balancer_attributes_output import HealthLogForDescribeLoadBalancerAttributesOutput
 from volcenginesdkalb.models.ipv6_eip_billing_config_for_clone_load_balancer_input import Ipv6EipBillingConfigForCloneLoadBalancerInput
 from volcenginesdkalb.models.ipv6_eip_billing_config_for_create_load_balancer_input import Ipv6EipBillingConfigForCreateLoadBalancerInput
@@ -195,6 +198,7 @@
 from volcenginesdkalb.models.rule_for_modify_rules_input import RuleForModifyRulesInput
 from volcenginesdkalb.models.server_for_add_server_group_backend_servers_input import ServerForAddServerGroupBackendServersInput
 from volcenginesdkalb.models.server_for_describe_server_group_attributes_output import ServerForDescribeServerGroupAttributesOutput
+from volcenginesdkalb.models.server_for_describe_server_group_backend_servers_output import ServerForDescribeServerGroupBackendServersOutput
 from volcenginesdkalb.models.server_for_modify_server_group_backend_servers_input import ServerForModifyServerGroupBackendServersInput
 from volcenginesdkalb.models.server_group_for_describe_listener_attributes_output import ServerGroupForDescribeListenerAttributesOutput
 from volcenginesdkalb.models.server_group_for_describe_listeners_output import ServerGroupForDescribeListenersOutput
@@ -205,20 +209,40 @@
 from volcenginesdkalb.models.sticky_session_config_for_describe_server_groups_output import StickySessionConfigForDescribeServerGroupsOutput
 from volcenginesdkalb.models.sticky_session_config_for_modify_server_group_attributes_input import StickySessionConfigForModifyServerGroupAttributesInput
 from volcenginesdkalb.models.tls_access_log_for_describe_load_balancer_attributes_output import TLSAccessLogForDescribeLoadBalancerAttributesOutput
+from volcenginesdkalb.models.tag_filter_for_describe_acls_input import TagFilterForDescribeAclsInput
+from volcenginesdkalb.models.tag_filter_for_describe_all_certificates_input import TagFilterForDescribeAllCertificatesInput
+from volcenginesdkalb.models.tag_filter_for_describe_ca_certificates_input import TagFilterForDescribeCACertificatesInput
+from volcenginesdkalb.models.tag_filter_for_describe_certificates_input import TagFilterForDescribeCertificatesInput
+from volcenginesdkalb.models.tag_filter_for_describe_customized_cfgs_input import TagFilterForDescribeCustomizedCfgsInput
+from volcenginesdkalb.models.tag_filter_for_describe_health_check_templates_input import TagFilterForDescribeHealthCheckTemplatesInput
 from volcenginesdkalb.models.tag_filter_for_describe_listeners_input import TagFilterForDescribeListenersInput
 from volcenginesdkalb.models.tag_filter_for_describe_load_balancers_input import TagFilterForDescribeLoadBalancersInput
 from volcenginesdkalb.models.tag_filter_for_describe_server_groups_input import TagFilterForDescribeServerGroupsInput
 from volcenginesdkalb.models.tag_filter_for_list_tags_for_resources_input import TagFilterForListTagsForResourcesInput
+from volcenginesdkalb.models.tag_for_create_acl_input import TagForCreateAclInput
+from volcenginesdkalb.models.tag_for_create_customized_cfg_input import TagForCreateCustomizedCfgInput
 from volcenginesdkalb.models.tag_for_create_listener_input import TagForCreateListenerInput
 from volcenginesdkalb.models.tag_for_create_load_balancer_input import TagForCreateLoadBalancerInput
 from volcenginesdkalb.models.tag_for_create_server_group_input import TagForCreateServerGroupInput
+from volcenginesdkalb.models.tag_for_describe_acl_attributes_output import TagForDescribeAclAttributesOutput
+from volcenginesdkalb.models.tag_for_describe_acls_output import TagForDescribeAclsOutput
+from volcenginesdkalb.models.tag_for_describe_all_certificates_output import TagForDescribeAllCertificatesOutput
+from volcenginesdkalb.models.tag_for_describe_ca_certificates_output import TagForDescribeCACertificatesOutput
+from volcenginesdkalb.models.tag_for_describe_certificates_output import TagForDescribeCertificatesOutput
+from volcenginesdkalb.models.tag_for_describe_customized_cfg_attributes_output import TagForDescribeCustomizedCfgAttributesOutput
+from volcenginesdkalb.models.tag_for_describe_customized_cfgs_output import TagForDescribeCustomizedCfgsOutput
+from volcenginesdkalb.models.tag_for_describe_health_check_templates_output import TagForDescribeHealthCheckTemplatesOutput
 from volcenginesdkalb.models.tag_for_describe_listener_attributes_output import TagForDescribeListenerAttributesOutput
 from volcenginesdkalb.models.tag_for_describe_listeners_output import TagForDescribeListenersOutput
 from volcenginesdkalb.models.tag_for_describe_load_balancer_attributes_output import TagForDescribeLoadBalancerAttributesOutput
 from volcenginesdkalb.models.tag_for_describe_load_balancers_output import TagForDescribeLoadBalancersOutput
 from volcenginesdkalb.models.tag_for_describe_server_group_attributes_output import TagForDescribeServerGroupAttributesOutput
 from volcenginesdkalb.models.tag_for_describe_server_groups_output import TagForDescribeServerGroupsOutput
+from volcenginesdkalb.models.tag_for_replace_ca_certificate_input import TagForReplaceCACertificateInput
+from volcenginesdkalb.models.tag_for_replace_certificate_input import TagForReplaceCertificateInput
 from volcenginesdkalb.models.tag_for_tag_resources_input import TagForTagResourcesInput
+from volcenginesdkalb.models.tag_for_upload_ca_certificate_input import TagForUploadCACertificateInput
+from volcenginesdkalb.models.tag_for_upload_certificate_input import TagForUploadCertificateInput
 from volcenginesdkalb.models.tag_resources_request import TagResourcesRequest
 from volcenginesdkalb.models.tag_resources_response import TagResourcesResponse
 from volcenginesdkalb.models.untag_resources_request import UntagResourcesRequest

volcenginesdkalb/api/alb_api.py

@@ -3331,6 +3331,103 @@ def describe_server_group_attributes_with_http_info(self, body, **kwargs):  # no
             _request_timeout=params.get('_request_timeout'),
             collection_formats=collection_formats)
 
+    def describe_server_group_backend_servers(self, body, **kwargs):  # noqa: E501
+        """describe_server_group_backend_servers  # noqa: E501
+
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please pass async_req=True
+        >>> thread = api.describe_server_group_backend_servers(body, async_req=True)
+        >>> result = thread.get()
+
+        :param async_req bool
+        :param DescribeServerGroupBackendServersRequest body: (required)
+        :return: DescribeServerGroupBackendServersResponse
+                 If the method is called asynchronously,
+                 returns the request thread.
+        """
+        kwargs['_return_http_data_only'] = True
+        if kwargs.get('async_req'):
+            return self.describe_server_group_backend_servers_with_http_info(body, **kwargs)  # noqa: E501
+        else:
+            (data) = self.describe_server_group_backend_servers_with_http_info(body, **kwargs)  # noqa: E501
+            return data
+
+    def describe_server_group_backend_servers_with_http_info(self, body, **kwargs):  # noqa: E501
+        """describe_server_group_backend_servers  # noqa: E501
+
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please pass async_req=True
+        >>> thread = api.describe_server_group_backend_servers_with_http_info(body, async_req=True)
+        >>> result = thread.get()
+
+        :param async_req bool
+        :param DescribeServerGroupBackendServersRequest body: (required)
+        :return: DescribeServerGroupBackendServersResponse
+                 If the method is called asynchronously,
+                 returns the request thread.
+        """
+
+        all_params = ['body']  # noqa: E501
+        all_params.append('async_req')
+        all_params.append('_return_http_data_only')
+        all_params.append('_preload_content')
+        all_params.append('_request_timeout')
+
+        params = locals()
+        for key, val in six.iteritems(params['kwargs']):
+            if key not in all_params:
+                raise TypeError(
+                    "Got an unexpected keyword argument '%s'"
+                    " to method describe_server_group_backend_servers" % key
+                )
+            params[key] = val
+        del params['kwargs']
+        # verify the required parameter 'body' is set
+        if self.api_client.client_side_validation and ('body' not in params or
+                                                       params['body'] is None):  # noqa: E501
+            raise ValueError("Missing the required parameter `body` when calling `describe_server_group_backend_servers`")  # noqa: E501
+
+        collection_formats = {}
+
+        path_params = {}
+
+        query_params = []
+
+        header_params = {}
+
+        form_params = []
+        local_var_files = {}
+
+        body_params = None
+        if 'body' in params:
+            body_params = params['body']
+        # HTTP header `Accept`
+        header_params['Accept'] = self.api_client.select_header_accept(
+            ['application/json'])  # noqa: E501
+
+        # HTTP header `Content-Type`
+        header_params['Content-Type'] = self.api_client.select_header_content_type(  # noqa: E501
+            ['text/plain'])  # noqa: E501
+
+        # Authentication setting
+        auth_settings = ['volcengineSign']  # noqa: E501
+
+        return self.api_client.call_api(
+            '/DescribeServerGroupBackendServers/2020-04-01/alb/get/text_plain/', 'GET',
+            path_params,
+            query_params,
+            header_params,
+            body=body_params,
+            post_params=form_params,
+            files=local_var_files,
+            response_type='DescribeServerGroupBackendServersResponse',  # noqa: E501
+            auth_settings=auth_settings,
+            async_req=params.get('async_req'),
+            _return_http_data_only=params.get('_return_http_data_only'),
+            _preload_content=params.get('_preload_content', True),
+            _request_timeout=params.get('_request_timeout'),
+            collection_formats=collection_formats)
+
     def describe_server_groups(self, body, **kwargs):  # noqa: E501
         """describe_server_groups  # noqa: E501