Merge 'integration_2025-11-06_1076451254274' into 'master'

merge branch integration_2025-11-06_1076451254274 into master

See merge request: !904

Author: bytestarter

SDK_Integration_zh.md

@@ -13,6 +13,7 @@
   - [自定义RegionId](#自定义regionid)
   - [自动化Endpoint寻址](#自动化endpoint寻址)
     - [Endpoint默认寻址](#endpoint默认寻址)
+    - [Endpoint标准寻址](#endpoint标准寻址)
 - [Http连接池配置](#http连接池配置)
 - [Https请求配置](#https请求配置)
   - [指定scheme](#指定scheme)
@@ -415,6 +416,33 @@ configuration.custom_bootstrap_region = {
 volcenginesdkcore.Configuration.set_default(configuration)
 ```
 
+### Endpoint标准寻址
+**标准寻址规则**  
+
+| Global服务 | 双栈 | 格式                                                                                                               |
+|----------|----|------------------------------------------------------------------------------------------------------------------|
+| 是        | 是  | `{Service}.volcengine-api.com`                                                                                   |
+| 是        | 否  | `{Service}.volcengineapi.com`                                                                                    |
+| 否        | 是  | `{Service}.{region}.volcengine-api.com`|
+| 否        | 否  | `{Service}.{region}.volcengineapi.com` |
+
+**代码示例：**  
+
+是否global服务根据具体调用的服务决定的，是否global无法修改的。  
+可以参考列表：[./volcenginesdkcore/endpoint/providers/standard_provider.py#ServiceInfos](./volcenginesdkcore/endpoint/providers/standard_provider.py#L51)  
+```python
+import volcenginesdkcore
+from volcenginesdkcore.endpoint.providers.standard_provider import StandardEndpointResolver
+configuration = volcenginesdkcore.Configuration()
+configuration.ak = "Your ak"
+configuration.sk = "Your sk"
+configuration.endpoint_provider = StandardEndpointResolver() # 配置标准寻址
+configuration.use_dual_stack = True # 配置是否双栈
+configuration.region = "cn-beijing" # 配置region
+volcenginesdkcore.Configuration.set_default(configuration)
+```
+
+
 # Http连接池配置
 
 > **默认**  

meta.json

@@ -1,4 +1,4 @@
 {
-	"lasted": "4.0.31",
-	"meta_commit": "8724fb294f8c22b4dbe5c1dd0430a9e286f03fb7"
+	"lasted": "4.0.32",
+	"meta_commit": "615e689185f8dc78fa72869fb8df272ab3343113"
 }

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "volcengine-python-sdk"
-version = "4.0.31"
+version = "4.0.32"
 authors = [
     {name = "volc-engine", email = "[email protected]"},
 ]

setup.py

@@ -3,7 +3,7 @@
 from setuptools import setup, find_packages  # noqa: H301
 
 NAME = "volcengine-python-sdk"
-VERSION = "4.0.31"
+VERSION = "4.0.32"
 # To install the library, run the following
 #
 # python setup.py install

volcenginesdkcore/api_client.py

@@ -64,7 +64,7 @@ def __init__(self, configuration=None, header_name=None, header_value=None,
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'volcstack-python-sdk/4.0.31'
+        self.user_agent = 'volcstack-python-sdk/4.0.32'
         self.client_side_validation = configuration.client_side_validation
 
         self.interceptor_chain = InterceptorChain()

volcenginesdkcore/configuration.py

@@ -272,7 +272,7 @@ def to_debug_report(self):
                "OS: {env}\n" \
                "Python Version: {pyversion}\n" \
                "Version of the API: 0.1.0\n" \
-               "SDK Package Version: 4.0.31".\
+               "SDK Package Version: 4.0.32".\
             format(env=sys.platform, pyversion=sys.version)
 
     @property