全部產品
Search
文件中心

Alibaba Cloud SDK:Endpoint

更新時間:Jul 01, 2024

Endpoint 是請求介面服務的網路網域名稱,如 ecs.cn-hangzhou.aliyuncs.com。

新版SDK Endpoint

新版 SDK 在 Endpoint 定址上簡化了許多,只提供了最容易理解的兩種方式,下面按優先順序排列:

  1. 使用者自訂:使用者可以通過在初始化時指定雲產品 Client 執行個體的請求地址,產品的 Endpoint 可以通過 OpenAPI 開發人員門戶的產品首頁中尋找

  2. from alibabacloud_tea_openapi.models import Config
    
    config = Config(
        # 省略憑證配置
        endpoint='<endpoint>'  # endpoint
    )
    
  3. Endpoint 拼接規則:在請求產品 SDK 具有 Endpoint 資料時,當前通過 RegionId 定址的邏輯才會生效,否則會在執行個體化 Client 對象時拋出異常 TeaException ,其 message 為 config.endpoint can not be empty,必須使用使用者自訂的方式指定 Endpoint。 Endpoint 資料檔案樣本,其中不具備的 Region 會通過拼接規則:{產品 Id}.{RegionId}.aliyuncs.com 來進行拼接。

  4. 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 可以通過在平台 開發人員門戶 上尋找:

  1. 開啟雲產品首頁:在首頁選擇相應雲產品,例如 ECS:

image.png

2. 找到服務地區列表:

image.png

3. 選擇相應 Region 所對應的 Endpoint,進行複製粘貼即可。

還可以這樣尋找

在 API 調試介面,找到對應介面,選擇服務地址 Region,平台會自動產生 SDK 代碼,代碼中可以查看需要的 Endpoint。

image.png