Endpoint設置

V2.0 SDK提供了兩種Endpoint設置方式，下面按優先級排列：

1. 自定義Endpoint：用戶可以通過在初始化客戶端時指定Endpoint，產品的Endpoint可以通過OpenAPI 開發者門戶的產品主頁中查找，具體參考文末。

   from alibabacloud_tea_openapi.models import Config
   
   config = Config(
       # 省略憑證配置
       endpoint='<endpoint>'  # endpoint
   )
   

2. 自定義RegionId：

   • 若請求的產品SDK中存在RegionId和Endpoint關系對象，且傳入的RegionId在該對象中時，則從關系對象中獲取Endpoint。

   • 若請求的產品SDK沒有RegionId和Endpoint關系對象，或者傳入的RegionId不在關系對象中時，則根據拼接規則自動拼接Endpoint。

   from alibabacloud_tea_openapi.models import Config
   
   config = Config(
       # 省略憑證配置
       region_id='cn-hangzhou',  # 通過 regionId 映射到 endpoint
   )
   

VPC Endpoint使用場景

使用阿里云SDK方式調用OpenAPI時，若業務場景有以下需求，建議設置阿里云VPC Endpoint：

• 業務系統同時存在于本地機房和云上機房，基于阿里云VPC搭建不同的業務模塊，構建完全隔離的云上環境，云上云下通過公網進行業務交互。

• 基于阿里云VPC搭建云上數據中心，通過專線與云下內部數據中心打通，進行用戶核心數據安全保障，完美應對業務激增及數據快速同步，實現混合云方案。

• 基于阿里云VPC搭建多個應用，各應用都需要對外提供服務，且其波峰時間點不一致，希望多IP共享帶寬，盡量減小波峰波谷效應從而降低成本。

• 云上業務完全基于VPC構建，用戶遍布各個區域，為提升用戶訪問速度，業務系統同樣位于不同節點，需實現各節點之間的網絡高速互聯。

獲取文件上傳授權碼的Endpoint

部分OpenAPI支持設置開放平臺Endpoint，如果不設置，則使用默認的公網服務地址。它底層業務邏輯是調用文件上傳鑒權服務，獲取鑒權和默認對象存儲（OSS）的相關信息。

• 上傳文件鑒權服務Endpoint，您可以在VPC環境配置VPC Endpoint來請求上傳文件的鑒權信息。

from alibabacloud_tea_openapi.models import Config
from alibabacloud_tea_util.models import RuntimeOptions

from alibabacloud_facebody20191230.models import DetectBodyCountAdvanceRequest
from alibabacloud_facebody20191230.client import Client

runtime = RuntimeOptions()
config = Config(
    # 省略憑證配置
    region_id='cn-hangzhou',
    # 文件上傳鑒權服務Endpoint
    open_platform_endpoint='openplatform-vpc.cn-shanghai.aliyuncs.com'
)

client = Client(config)
with open('test.txt', 'rb') as f:
    request = DetectBodyCountAdvanceRequest(image_urlobject=f)
    response = client.detect_body_count_advance(request, runtime)
    # response 包含服務端響應的 body 和 headers
    print(response.body)
    print(response.headers)

• 上傳文件鑒權服務的Endpoint，您可以在VPC或者內網環境配置VPC Endpoint來請求上傳文件的鑒權信息。

from alibabacloud_tea_openapi.models import Config
from alibabacloud_tea_util.models import RuntimeOptions

from alibabacloud_facebody20191230.models import DetectBodyCountAdvanceRequest
from alibabacloud_facebody20191230.client import Client

runtime = RuntimeOptions()
config = Config(
    # 省略憑證配置
    region_id='cn-hangzhou',
    open_platform_endpoint='openplatform-vpc.cn-shanghai.aliyuncs.com',
    endpoint_type='internal'  # 設置通過 OSS 內網地址上傳文件
)

client = Client(config)
with open('test.txt', 'rb') as f:
    request = DetectBodyCountAdvanceRequest(image_urlobject=f)
    response = client.detect_body_count_advance(request, runtime)
    # response 包含服務端響應的 body 和 headers
    print(response.body)
    print(response.headers)

附：Endpoint查找方式

產品的Endpoint可以通過在OpenAPI門戶上尋找：

1. 在門戶頂部菜單選擇云產品，例如ECS：

2. 在云產品主頁找到服務區域列表：

3. 選擇相應RegionId所對應的Endpoint，進行復制粘貼即可。

還可以在API調試界面，在左側欄單擊服務區域，查看云產品支持的Endpoint。