Endpoint又叫服務存取點,是請求介面服務的網路網域名稱,如產品ECS在杭州地區的Endpoint:ecs.cn-hangzhou.aliyuncs.com。每個產品都有其獨立的Endpoint,並且Endpoint與服務地區RegionId有關,不同地區可能是不同的Endpoint。本節主要介紹V2.0 SDK對於Endpoint的配置。
Endpoint類型
服務存取點主要有兩類:公網服務地址、VPC服務地址,更多資訊請參見服務存取點。
Endpoint設定
V2.0 SDK提供了兩種Endpoint設定方式,下面按優先順序排列:
說明
建議您使用自訂Endpoint方式設定。
指定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);
指定RegionId:通過定址邏輯擷取Endpoint。
若請求的產品SDK中存在RegionId和Endpoint映射關聯性物件,且傳入的RegionId在該對象中,則從映射關聯性物件中擷取Endpoint。
若請求的產品SDK沒有RegionId和Endpoint映射關聯性物件,或者傳入的RegionId不在映射關聯性物件中,則根據拼接規則自動拼接Endpoint。拼接規則:
${產品 Id}.${RegionId}.aliyuncs.com
。
附:Endpoint尋找方式
產品的Endpoint可以通過在OpenAPI門戶上尋找:
在門戶頂部菜單選擇雲產品,例如ECS:
2. 在雲產品首頁找到服務地區列表:
3. 選擇相應RegionId所對應的Endpoint,進行複製粘貼即可。
還可以在API調試介面,在左側欄單擊服務地區,查看雲產品支援的Endpoint。