Endpoint 是請求介面服務的網路網域名稱,如 ecs.cn-hangzhou.aliyuncs.com。
新版SDK Endpoint
新版 SDK 在 Endpoint 定址上簡化了許多,只提供了最容易理解的兩種方式,下面按優先順序排列:
使用者自訂:使用者可以通過在初始化時指定雲產品 Client 執行個體的請求地址,產品的 Endpoint 可以通過 OpenAPI 開發人員門戶的產品首頁中尋找
Endpoint 拼接規則:在請求產品 SDK 具有 Endpoint 資料時,當前通過 RegionId 定址的邏輯才會生效,否則會在執行個體化 Client 對象時拋出異常 TeaException ,其 message 為 config.endpoint can not be empty,必須使用使用者自訂的方式指定 Endpoint。 Endpoint 資料檔案樣本,其中不具備的 Region 會通過拼接規則:{產品 Id}.{RegionId}.aliyuncs.com 來進行拼接。
from alibabacloud_tea_openapi.models import Config
config = Config(
# 省略憑證配置
endpoint='<endpoint>' # endpoint
)
from alibabacloud_tea_openapi.models import Config
config = Config(
# 省略憑證配置
region_id='cn-hangzhou', # 通過 regionId 映射到 endpoint
)
檔案上傳 Endpoint
新版本 SDK 還為使用者提供了檔案上傳的 Endpoint 配置,分為兩個:
鑒權服務 openplatform 的地址,可以在 VPC 環境配置 VPC 地址來請求上傳檔案的鑒權資訊。
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'
)
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)
上傳檔案的地址,可以在 VPC 或者內網環境配置內網的地址來上傳檔案。
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 可以通過在平台 開發人員門戶 上尋找:
開啟雲產品首頁:在首頁選擇相應雲產品,例如 ECS:
2. 找到服務地區列表:
3. 選擇相應 Region 所對應的 Endpoint,進行複製粘貼即可。
還可以這樣尋找:
在 API 調試介面,找到對應介面,選擇服務地址 Region,平台會自動產生 SDK 代碼,代碼中可以查看需要的 Endpoint。