全部产品
Search
文档中心

阿里云SDK:Endpoint配置

更新时间:Nov 18, 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。

    image
    • 若请求的产品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