Alibaba Cloud SDK：Endpoint配置

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，如果不設定，則使用預設的公網服務地址。它底層商務邏輯是調用檔案上傳鑒權服務，擷取鑒權和預設Object Storage Service的相關資訊。

• 上傳檔案鑒權服務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。