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。