全部產品
Search
文件中心

Alibaba Cloud SDK:Endpoint配置

更新時間:Nov 19, 2024

Endpoint又叫服務存取點,是請求介面服務的網路網域名稱,如產品ECS在杭州地區的Endpoint:ecs.cn-hangzhou.aliyuncs.com。每個產品都有其獨立的Endpoint,並且Endpoint與服務地區RegionId有關,不同地區可能是不同的Endpoint。本節主要介紹V2.0 SDK對於Endpoint的配置。

Endpoint類型

服務存取點主要有兩類:公網服務地址、VPC服務地址,更多資訊請參見服務存取點

Endpoint設定

V2.0 SDK提供了兩種Endpoint設定方式,下面按優先順序排列:

說明

建議您使用自訂Endpoint方式設定。

  1. 指定Endpoint:使用者可以通過在初始化用戶端時指定Endpoint,產品的Endpoint可以通過OpenAPI 開發人員門戶的產品首頁中尋找,具體參考文末。

    AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
    {
        // 必填,請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID。
        AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
        // 必填,請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
        AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
    };
    // 自訂Endpoint
    config.Endpoint = "dysmsapi.aliyuncs.com";
    AlibabaCloud.SDK.Dysmsapi20170525.Client client = new AlibabaCloud.SDK.Dysmsapi20170525.Client(config);
  2. 指定RegionId:通過定址邏輯擷取Endpoint。

    • 若請求的產品SDK中存在RegionId和Endpoint映射關聯性物件,且傳入的RegionId在該對象中,則從映射關聯性物件中擷取Endpoint。

    • 若請求的產品SDK沒有RegionId和Endpoint映射關聯性物件,或者傳入的RegionId不在映射關聯性物件中,則根據拼接規則自動拼接Endpoint。拼接規則:${產品 Id}.${RegionId}.aliyuncs.com

附:Endpoint尋找方式

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

  1. 在門戶頂部菜單選擇雲產品,例如ECS:

image.png

2. 在雲產品首頁找到服務地區列表

image.png

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

還可以在API調試介面,在左側欄單擊服務地區,查看雲產品支援的Endpoint。

image