byteplus-python-sdk-v2 3.0.56__py2.py3-none-any.whl → 3.0.57__py2.py3-none-any.whl

{byteplus_python_sdk_v2-3.0.56.dist-info → byteplus_python_sdk_v2-3.0.57.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: byteplus-python-sdk-v2
-Version: 3.0.56
+Version: 3.0.57
 Summary: Byteplus SDK for Python
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/byteplus-sdk/byteplus-python-sdk-v2

{byteplus_python_sdk_v2-3.0.56.dist-info → byteplus_python_sdk_v2-3.0.57.dist-info}/RECORD

@@ -1,5 +1,5 @@
-byteplus_python_sdk_v2-3.0.56.dist-info/licenses/LICENSE.txt,sha256=jG2zQEdRNt88EgHUWPpXVWmOrOduUQRx7MnYV9YIPaw,11359
-byteplus_python_sdk_v2-3.0.56.dist-info/licenses/NOTICE.md,sha256=vSw_bTkZl1MYBrGol3tpO6B6OLLFRpaw0z5cun0_0QE,85
+byteplus_python_sdk_v2-3.0.57.dist-info/licenses/LICENSE.txt,sha256=jG2zQEdRNt88EgHUWPpXVWmOrOduUQRx7MnYV9YIPaw,11359
+byteplus_python_sdk_v2-3.0.57.dist-info/licenses/NOTICE.md,sha256=vSw_bTkZl1MYBrGol3tpO6B6OLLFRpaw0z5cun0_0QE,85
 byteplussdkalb/__init__.py,sha256=hgNQF2o0CFabtxQHh0xHHZ5oHcz3bQ6wHpRkA9B8nuo,30746
 byteplussdkalb/api/__init__.py,sha256=H6iQBCnNKuvuPDr57uNOlglabIkEAd4CncI0rnwwEoE,133
 byteplussdkalb/api/alb_api.py,sha256=kWP7DNDolXb02v4nD5VmEjSmeddM-aBrHPGCIdC7ogY,249907
@@ -2076,8 +2076,8 @@ byteplussdkcloudmonitor/models/update_silence_policy_response.py,sha256=3PZTcDF2
 byteplussdkcloudmonitor/models/update_webhook_request.py,sha256=UuA9Ua57eLThwa7cVq5xPegHf-e3W2aGti5CLTBYf1U,7041
 byteplussdkcloudmonitor/models/update_webhook_response.py,sha256=Icjg1daq1uG0V3l7R_QVPkHvLCe1uXU1OphnDhoZ91A,3424
 byteplussdkcore/__init__.py,sha256=QD2qSwKMsMeYxsEQIdWce5ekPilRexqkWCP_q3YOqvo,308
-byteplussdkcore/api_client.py,sha256=9HOL4N2ojUZ6qL_6kiE6E0DgiK03WUrfpvH91nT2mVc,28251
-byteplussdkcore/configuration.py,sha256=6sQ0419lwxgtaJZBtAKFM6oE_BsrxOS_O2i3crK9omM,11924
+byteplussdkcore/api_client.py,sha256=XXms3Y_lAkLGL8wQfdsEaHQMGFT7bKLD3PlpiGBTqVM,28251
+byteplussdkcore/configuration.py,sha256=mUj9Icy0f6ri7J4PgYjuqS2f2_BqyJ0TcHZ2nMMeJLE,11924
 byteplussdkcore/endpoint.py,sha256=L5Dw0-Cia9ezYxGJFgZ9td-mCM4AqSIZv67ll1sSzMY,1630
 byteplussdkcore/flatten.py,sha256=g3r61JS_AO7WV6ClRDkXgtnVXcw3c7tbZjeLAJxkSLc,3811
 byteplussdkcore/metadata.py,sha256=Km5jOllvPViXn0rdx604nIq0OF1RBF3Q2x-xA2cDXc8,4518
@@ -2100,8 +2100,8 @@ byteplussdkcore/auth/providers/sts_saml_provider.py,sha256=yedLynY4rwG81Xm9y2vfa
 byteplussdkcore/endpoint/__init__.py,sha256=K7dXFGGh0QYiALOLgtPxboGYzwCJB5IHseGSQPObZdQ,117
 byteplussdkcore/endpoint/endpoint_provider.py,sha256=9ajUjf2N2NmThuWrMm5QgLtmh8YbPas5TdvkAZYQ9lM,330
 byteplussdkcore/endpoint/providers/__init__.py,sha256=FmxBi_siUNTZod9GFOk5VG-UVYT7daNt4hZ2zifqYY8,76
-byteplussdkcore/endpoint/providers/default_provider.py,sha256=fgJN79idJPr9xbL_-VrRMvMhRcFWjKptHTB_zOgZWZY,12035
-byteplussdkcore/endpoint/providers/standard_provider.py,sha256=6pi5bpvML_KRnfi0cLO-dxUdZH8jeQiD7TrI_lCRQnA,12439
+byteplussdkcore/endpoint/providers/default_provider.py,sha256=fKlBzYXjws9qGNJswN9SrQYpaqIP7HlOZkEvbls2jY8,10352
+byteplussdkcore/endpoint/providers/standard_provider.py,sha256=UjRAIoU8A-xPOn-KjrbdbC42W55vSAq640VBgyrFRng,12784
 byteplussdkcore/feature/__init__.py,sha256=ev2S2XGLZUjbL7sylBd3NWmqGmcDcYV-Oj4qPZOztHU,154
 byteplussdkcore/feature/rds/__init__.py,sha256=g4-6e-OdBADN9_WzILg8P69KdSVSc5TyOg5CrXglE5A,119
 byteplussdkcore/feature/rds/connect_utils.py,sha256=Z_sJjNdRYXUKP9Ygi4tNWnUWBH-ueYekb3E0SW2vAPY,3177
@@ -10818,7 +10818,7 @@ byteplussdkvs20260714/models/create_voice_task_response.py,sha256=OXVaSMuIQeR-3K
 byteplussdkvs20260714/models/data_for_create_voice_task_output.py,sha256=3AHvvVdW-XqrWaemto4rTkAGH7xC5LIECPM31j_v5D0,3526
 byteplussdkvs20260714/models/number_info_list_for_create_voice_task_input.py,sha256=nRyRZ8MvLxJpdNNV3htDSWDkcwDR6fskvq0cT5z5Cuw,4503
 byteplussdkvs20260714/models/voice_content_for_create_voice_task_input.py,sha256=x8z0fVEr0Uay3FuhGGJm5vrLdFMT5Qr2srJDUA3C_jA,8119
-byteplus_python_sdk_v2-3.0.56.dist-info/METADATA,sha256=5gr6aK8MT6DCAiOK3LmwhhYqEXpSR_MBe-xR-4czxwU,4824
-byteplus_python_sdk_v2-3.0.56.dist-info/WHEEL,sha256=qWEHOWeXof9kJLXAXJ1hukQ_MvVtaV9UUAew6N7Y99E,109
-byteplus_python_sdk_v2-3.0.56.dist-info/top_level.txt,sha256=-iSSKg52spQd1bbe9WcS7sHO_gVkw5TPmFWg7vPjItE,1163
-byteplus_python_sdk_v2-3.0.56.dist-info/RECORD,,
+byteplus_python_sdk_v2-3.0.57.dist-info/METADATA,sha256=XeTyjzV1yQjSrRhddec-fu2T7qDHzgeSp0zbQQTe1f4,4824
+byteplus_python_sdk_v2-3.0.57.dist-info/WHEEL,sha256=qWEHOWeXof9kJLXAXJ1hukQ_MvVtaV9UUAew6N7Y99E,109
+byteplus_python_sdk_v2-3.0.57.dist-info/top_level.txt,sha256=-iSSKg52spQd1bbe9WcS7sHO_gVkw5TPmFWg7vPjItE,1163
+byteplus_python_sdk_v2-3.0.57.dist-info/RECORD,,

byteplussdkcore/api_client.py

@@ -68,7 +68,7 @@ class ApiClient(object):
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'byteplus-python-sdk-v2/3.0.56'
+        self.user_agent = 'byteplus-python-sdk-v2/3.0.57'
         self.client_side_validation = configuration.client_side_validation
 
         self.interceptor_chain = InterceptorChain()

byteplussdkcore/configuration.py

@@ -287,7 +287,7 @@ class Configuration(six.with_metaclass(TypeWithDefault, object)):
                "OS: {env}\n" \
                "Python Version: {pyversion}\n" \
                "Version of the API: 0.1.0\n" \
-               "SDK Package Version: 3.0.56".\
+               "SDK Package Version: 3.0.57".\
             format(env=sys.platform, pyversion=sys.version)
 
     @property

byteplussdkcore/endpoint/providers/default_provider.py

@@ -8,47 +8,78 @@ from byteplussdkcore.observability.debugger import sdk_core_logger
 open_prefix = 'open'
 endpoint_suffix = '.byteplusapi.com'
 dualstack_endpoint_suffix = '.byteplus-api.com'
-fallback_endpoint = open_prefix + '.ap-southeast-1.byteplusapi.com'
+
+
+class ServiceEndpointInfoMissingError(Exception):
+    """Raised when a service is not registered in ``default_endpoint``.
+
+    Mirrors Go's ``ErrServiceEndpointInfoMissing`` and Java's ``ApiException``
+    thrown by ``DefaultEndpointProvider.getDefaultEndpointByServiceInfo`` for
+    the same condition.
+    """
+
+    def __init__(self, service):
+        self.service = service
+        super(ServiceEndpointInfoMissingError, self).__init__(
+            "byteplussdkcore: service endpoint info missing: service {!r} "
+            "not registered".format(service)
+        )
 
 region_code_cn_beijing_auto_driving = "cn-beijing-autodriving"
 region_code_ap_southeast2 = "ap-southeast-2"
 region_code_ap_southeast3 = "ap-southeast-3"
 region_code_cn_hongkong = 'cn-hongkong'
 
-bootstrap_region = {
-    region_code_ap_southeast2: {},
-    region_code_ap_southeast3: {},
-}
+# Region-level whitelist of cn-* regions that should resolve to the
+# international ``.byteplusapi.com`` suffix rather than the Chinese mainland
+# ``.byteplusapi.com.cn`` suffix.
+_cn_non_mainland_region_set = {region_code_cn_hongkong}
+
+
+def _normalize_region(region):
+    if region is None:
+        return ''
+    return region.strip().lower()
+
+
+def _is_cn_mainland_region(region):
+    """Returns whether ``region`` is a mainland cn-* region resolving to the
+    ``.byteplusapi.com.cn`` suffix. Regions in :data:`_cn_non_mainland_region_set`
+    (for example ``cn-hongkong``) are treated as international.
+    """
+    if not region.startswith('cn-'):
+        return False
+    return region not in _cn_non_mainland_region_set
 
 
 class ServiceEndpointInfo:
 
-    def __init__(self, service, is_global, global_endpoint,
-                 region_endpoint_map, fallback_endpoint=fallback_endpoint):
+    def __init__(self, service, is_global, go_china_enabled=False,
+                 global_endpoint='', region_endpoint_map=None):
         self.service = service
         self.is_global = is_global
+        self.go_china_enabled = go_china_enabled
+        # Optional overrides retained for ``custom_endpoints`` callers. The
+        # built-in ``default_endpoint`` table intentionally leaves them empty
+        # and drives resolution off ``is_global`` + ``go_china_enabled``, in
+        # line with the Go/Java ``ServiceEndpointInfo`` shape.
         self.global_endpoint = global_endpoint
-        self.region_endpoint_map = region_endpoint_map
-        self.fallback_endpoint = fallback_endpoint
+        self.region_endpoint_map = region_endpoint_map or {}
 
     @property
     def __standardize_domain_service_code(self):
         return self.service.lower().replace('_', '-')
 
-    @staticmethod
-    def __is_cn_region(region):
-        has_cn_prefix = region.startswith('cn-')
-        if not has_cn_prefix:
-            return False
-
-        cn_none_mainland_region = [region_code_cn_hongkong]
-        return region not in cn_none_mainland_region
-
     def get_endpoint_for(self, region, suffix=endpoint_suffix):
         sdk_core_logger.debug_endpoint(
             "get_endpoint_for start: service=%s, region=%s, suffix=%s",
             self.service, region, suffix
         )
+
+        normalized_region = _normalize_region(region)
+        cn_suffix = '.cn' if (self.go_china_enabled
+                              and _is_cn_mainland_region(normalized_region)) else ''
+
         if self.is_global:
             if self.global_endpoint:
                 sdk_core_logger.debug_endpoint(
@@ -56,197 +87,83 @@ class ServiceEndpointInfo:
                     self.service, self.global_endpoint
                 )
                 return self.global_endpoint
-            endpoint = self.__standardize_domain_service_code + suffix
+            endpoint = self.__standardize_domain_service_code + suffix + cn_suffix
             sdk_core_logger.debug_endpoint(
                 "build global endpoint from service code: %s", endpoint
             )
             return endpoint
-        if region in self.region_endpoint_map:
-            endpoint = self.region_endpoint_map[region]
+
+        if normalized_region in self.region_endpoint_map:
+            endpoint = self.region_endpoint_map[normalized_region]
             sdk_core_logger.debug_endpoint(
                 "use region endpoint from map: service=%s, region=%s, endpoint=%s",
                 self.service, region, endpoint
             )
             return endpoint
 
-        endpoint = self.__standardize_domain_service_code + '.' + region + suffix + \
-            ('.cn' if self.__is_cn_region(region) else '')
+        endpoint = (self.__standardize_domain_service_code + '.'
+                    + normalized_region + suffix + cn_suffix)
         sdk_core_logger.debug_endpoint(
             "build region endpoint by default rule: %s", endpoint
         )
-
         return endpoint
 
 
 default_endpoint = {
-    'ark': ServiceEndpointInfo(
-        service='ark',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=open_prefix + endpoint_suffix,
-    ),
-    'billing': ServiceEndpointInfo(
-        service='billing',
-        is_global=True,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=open_prefix + endpoint_suffix,
-    ),
-    'ecs': ServiceEndpointInfo(
-        service='ecs',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'vpc': ServiceEndpointInfo(
-        service='vpc',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'kms': ServiceEndpointInfo(
-        service='kms',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'eco_partner': ServiceEndpointInfo(
-        service='eco_partner',
-        is_global=True,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'iam': ServiceEndpointInfo(
-        service='iam',
-        is_global=True,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'cloudmonitor': ServiceEndpointInfo(
-        service='cloudmonitor',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'cpaas': ServiceEndpointInfo(
-        service='cpaas',
-        is_global=True,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'vepfs': ServiceEndpointInfo(
-        service='vepfs',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'vke': ServiceEndpointInfo(
-        service='vke',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'kickart': ServiceEndpointInfo(
-        service='kickart',
-        is_global=True,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'rds_mssql': ServiceEndpointInfo(
-        service='rds_mssql',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'sts': ServiceEndpointInfo(
-        service='sts',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'redis': ServiceEndpointInfo(
-        service='redis',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'vmp': ServiceEndpointInfo(
-        service='vmp',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'vs': ServiceEndpointInfo(
-        service='vs',
-        is_global=True,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'resourcecenter': ServiceEndpointInfo(
-        service='resourcecenter',
-        is_global=True,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'rds_mysql': ServiceEndpointInfo(
-        service='rds_mysql',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'privatelink': ServiceEndpointInfo(
-        service='privatelink',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'cen': ServiceEndpointInfo(
-        service='cen',
-        is_global=True,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'seccenter': ServiceEndpointInfo(
-        service='seccenter',
-        is_global=True,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'transitrouter': ServiceEndpointInfo(
-        service='transitrouter',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
-    'clawsentry': ServiceEndpointInfo(
-        service='clawsentry',
-        is_global=False,
-        global_endpoint='',
-        region_endpoint_map={},
-        fallback_endpoint=fallback_endpoint,
-    ),
+    'vpc': ServiceEndpointInfo('vpc', False, True),
+    'vke': ServiceEndpointInfo('vke', False, True),
+    'auto_scaling': ServiceEndpointInfo('auto_scaling', False, True),
+    'storage_ebs': ServiceEndpointInfo('storage_ebs', False, True),
+    'vedbm': ServiceEndpointInfo('vedbm', False, True),
+    'privatelink': ServiceEndpointInfo('privatelink', False, True),
+    'clb': ServiceEndpointInfo('clb', False, True),
+    'transitrouter': ServiceEndpointInfo('transitrouter', False, True),
+    'directconnect': ServiceEndpointInfo('directconnect', False, True),
+    'vpn': ServiceEndpointInfo('vpn', False, True),
+    'natgateway': ServiceEndpointInfo('natgateway', False, True),
+    'rds_mysql': ServiceEndpointInfo('rds_mysql', False, True),
+    'smc': ServiceEndpointInfo('smc', True, False),
+    'iam': ServiceEndpointInfo('iam', True, True),
+    'vepfs': ServiceEndpointInfo('vepfs', False, True),
+    'kms': ServiceEndpointInfo('kms', False, True),
+    'ecs': ServiceEndpointInfo('ecs', False, True),
+    'mongodb': ServiceEndpointInfo('mongodb', False, True),
+    'private_zone': ServiceEndpointInfo('private_zone', True, True),
+    'rds_postgresql': ServiceEndpointInfo('rds_postgresql', False, True),
+    'resource_share': ServiceEndpointInfo('resource_share', True, False),
+    'vmp': ServiceEndpointInfo('vmp', False, True),
+    'tag': ServiceEndpointInfo('tag', True, False),
+    'cr': ServiceEndpointInfo('cr', False, True),
+    'alb': ServiceEndpointInfo('alb', False, True),
+    'sts': ServiceEndpointInfo('sts', False, True),
+    'hbase': ServiceEndpointInfo('hbase', False, True),
+    'rds_mssql': ServiceEndpointInfo('rds_mssql', False, True),
+    'ml_platform': ServiceEndpointInfo('ml_platform', False, False),
+    'apig': ServiceEndpointInfo('apig', False, False),
+    'ark': ServiceEndpointInfo('ark', False, False),
+    'waf': ServiceEndpointInfo('waf', True, False),
+    'quota': ServiceEndpointInfo('quota', True, False),
+    'dms': ServiceEndpointInfo('dms', False, True),
+    'vefaas': ServiceEndpointInfo('vefaas', False, False),
+    'cen': ServiceEndpointInfo('cen', True, False),
+    'cp': ServiceEndpointInfo('cp', False, False),
+    'cloudmonitor': ServiceEndpointInfo('cloudmonitor', False, True),
+    'eco_partner': ServiceEndpointInfo('eco_partner', True, False),
+    'milvus': ServiceEndpointInfo('milvus', False, False),
+    'llmshield': ServiceEndpointInfo('llmshield', False, False),
+    'billing': ServiceEndpointInfo('billing', True, True),
+    'id': ServiceEndpointInfo('id', False, False),
+    'clawsentry': ServiceEndpointInfo('clawsentry', False, False),
+    'resourcecenter': ServiceEndpointInfo('resourcecenter', True, False),
+    'escloud': ServiceEndpointInfo('escloud', False, False),
+    'cpaas': ServiceEndpointInfo('cpaas', True, False),
+    'filenas': ServiceEndpointInfo('filenas', False, True),
+    'kafka': ServiceEndpointInfo('kafka', False, True),
+    'kickart': ServiceEndpointInfo('kickart', True, False),
+    'rabbitmq': ServiceEndpointInfo('rabbitmq', False, False),
+    'redis': ServiceEndpointInfo('redis', False, True),
+    'vod': ServiceEndpointInfo('vod', False, False),
+    'vs': ServiceEndpointInfo('vs', True, False),
 }
 
 
@@ -260,49 +177,19 @@ class DefaultEndpointProvider(EndpointProvider):
             "get_default_endpoint: service=%s, region=%s, suffix=%s",
             service, region, suffix
         )
-        if service in default_endpoint:
-            e = default_endpoint[service]
-            endpoint = e.get_endpoint_for(region, suffix)
+        if service not in default_endpoint:
             sdk_core_logger.debug_endpoint(
-                "resolved default endpoint: service=%s, endpoint=%s",
-                service, endpoint
+                "service %s not registered in default_endpoint", service
             )
-            return endpoint
+            raise ServiceEndpointInfoMissingError(service)
 
+        e = default_endpoint[service]
+        endpoint = e.get_endpoint_for(region, suffix)
         sdk_core_logger.debug_endpoint(
-            "service not found in default_endpoint, use fallback=%s", fallback_endpoint
+            "resolved default endpoint: service=%s, endpoint=%s",
+            service, endpoint
         )
-        return fallback_endpoint
-
-    def __in_bootstrap_region_list(self, region, custom_bootstrap_region):
-        region_code = region.strip()
-        bs_region_list_path = os.getenv('BYTEPLUS_BOOTSTRAP_REGION_LIST_CONF')
-        if bs_region_list_path:
-            try:
-                with open(bs_region_list_path, 'r') as f:
-                    content = f.read()
-                    lines = content.split('\n')
-                    for line in lines:
-                        line = line.strip()
-                        if not line:
-                            continue
-                        if line == region_code:
-                            return True
-            except Exception as e:
-                warnings.warn(
-                    'failed to read bootstrap region list from file ' + bs_region_list_path + ': ' + str(e),
-                    Warning,
-                    stacklevel=2
-                )
-
-        if bootstrap_region:
-            if region_code in bootstrap_region:
-                return True
-
-        if custom_bootstrap_region:
-            return region_code in custom_bootstrap_region
-
-        return False
+        return endpoint
 
     @staticmethod
     def __has_enabled_dualstack(use_dual_stack):
@@ -315,6 +202,17 @@ class DefaultEndpointProvider(EndpointProvider):
             "endpoint_for called: service=%s, region=%s, custom_bootstrap_region=%s, use_dual_stack=%s",
             service, region, custom_bootstrap_region, use_dual_stack
         )
+
+        # custom_bootstrap_region is deprecated and no longer participates in
+        # addressing. Retained in the signature for API compatibility.
+        if custom_bootstrap_region:
+            warnings.warn(
+                'custom_bootstrap_region is deprecated and no longer affects '
+                'endpoint resolution; the value is ignored.',
+                DeprecationWarning,
+                stacklevel=2,
+            )
+
         if service in self.custom_endpoints:
             conf = self.custom_endpoints[service]
             host = conf.get_endpoint_for(region)
@@ -324,23 +222,6 @@ class DefaultEndpointProvider(EndpointProvider):
             )
             return ResolvedEndpoint(host)
 
-        if custom_bootstrap_region is None:
-            custom_bootstrap_region = {}
-
-        if not self.__in_bootstrap_region_list(region, custom_bootstrap_region):
-            if service not in default_endpoint:
-                sdk_core_logger.debug_endpoint(
-                    "region=%s not in bootstrap list, service not in default endpoint fallback=%s",
-                    region, fallback_endpoint
-                )
-                return ResolvedEndpoint(fallback_endpoint)
-            host = default_endpoint[service].fallback_endpoint
-            sdk_core_logger.debug_endpoint(
-                "region=%s not in bootstrap list, service in default endpoint fallback=%s",
-                region, host
-            )
-            return ResolvedEndpoint(host)
-
         suffix = dualstack_endpoint_suffix if self.__has_enabled_dualstack(use_dual_stack) else endpoint_suffix
 
         host = self.get_default_endpoint(service=service, region=region, suffix=suffix)

byteplussdkcore/endpoint/providers/standard_provider.py

@@ -273,9 +273,9 @@ def is_go_china(region):
 class StandardEndpointResolver(EndpointProvider):
     def __init__(self, fmt=None, site_stack=None, extension=None, custom_services=None):
         self.fmt = fmt or DEFAULT_FORMAT
-        self.variables = StandardEndpointResolverVariable()
-        self.variables.site_stack = site_stack or SITE_STACK_BYTEPLUS_IPV4
-        self.variables.extension = extension or {}
+        # 只保存不可变配置模板；请求级 variables 在 endpoint_for 内每次新建，避免跨请求残留和并发串扰
+        self._default_site_stack = site_stack or SITE_STACK_BYTEPLUS_IPV4
+        self._default_extension = extension or {}
         self.custom_services = custom_services or {}
 
     def endpoint_for(self, service, region, custom_bootstrap_region=None, use_dual_stack=None, **kwargs):
@@ -290,8 +290,10 @@ class StandardEndpointResolver(EndpointProvider):
         # 2) 默认模板
         fmt = self.fmt or DEFAULT_FORMAT
 
-        # 3) 变量准备
-        self.variables.service = standardize_domain_service_code(service)
+        # 3) 请求级 variables：每次新建，防止跨请求残留与并发串扰
+        variables = StandardEndpointResolverVariable()
+        variables.extension = dict(self._default_extension)
+        variables.service = standardize_domain_service_code(service)
 
         svc_info = ServiceInfos.get(service)
         if not svc_info:
@@ -305,22 +307,25 @@ class StandardEndpointResolver(EndpointProvider):
 
         # 非全局服务拼接 ".{region}"，全局则为空
         if not svc_info.IsGlobal:
-            self.variables.region = "." + region
+            variables.region = "." + region
         else:
-            self.variables.region = ""
+            variables.region = ""
 
         # 4) IP 版本 -> SiteStack
         if use_dual_stack:
-            self.variables.site_stack = SITE_STACK_BYTEPLUS_DUAL_STACK
+            variables.site_stack = SITE_STACK_BYTEPLUS_DUAL_STACK
         else:
-            self.variables.site_stack = SITE_STACK_BYTEPLUS_IPV4
+            variables.site_stack = self._default_site_stack
 
+        # 5) CNSuffix：非全局 + 中国大陆才追加，其他情况显式清空
         if not svc_info.IsGlobal and is_go_china(region):
-            self.variables.cn_suffix = CN_SUFFIX
+            variables.cn_suffix = CN_SUFFIX
+        else:
+            variables.cn_suffix = ""
 
-        # 5) 渲染
+        # 6) 渲染
         try:
-            rendered = fmt.format(**self.variables.to_dict())
+            rendered = fmt.format(**variables.to_dict())
         except KeyError as err:
             raise StandProviderError(
                 "TemplateExecuteError",
@@ -329,7 +334,7 @@ class StandardEndpointResolver(EndpointProvider):
         except Exception as err:
             raise StandProviderError(
                 "TemplateExecuteError",
-                "failed to execute template for format %s, variable %r: %s" % (fmt, self.variables.to_dict(), err)
+                "failed to execute template for format %s, variable %r: %s" % (fmt, variables.to_dict(), err)
             )
 
         return ResolvedEndpoint(rendered)