首页/云/云平台与虚拟化速查/endpoint 服务接入点与内网调用
云基础与账号46 条

endpoint 服务接入点与内网调用

Endpoint 是云服务的 API 访问入口,通常按地域与网络类型区分(公网接入点与 VPC 内网接入点);同一服务在不同地域的接入点不同。

云平台与虚拟化速查云更新于 2026-10-13

endpoint 是什么

Endpoint 是云服务的 API 访问入口域名,通常按地域与网络类型区分:公网接入点走互联网链路,VPC 内网接入点走内网链路。同一个服务在不同地域的接入点不同,调用方初始化 SDK 时必须把接入点与 region 参数配对,否则会出现签名校验失败或请求路由到错误地域。

基本信息

适用平台各公有云 OpenAPI,SDK 与命令行工具均需配置接入点
区分维度服务名 + 地域 + 网络类型(公网 / VPC 内网)
内网优势不经过公网、不消耗公网带宽、时延更稳定
解析依赖内网接入点依赖 VPC 内 DNS 解析,跨账号 VPC 需先打通网络
配置位置SDK 初始化参数、CLI 配置文件、IaC 模板变量

典型使用场景

  • VPC 内业务调用云 API:使用内网接入点,省掉 NAT 与公网流量费用
  • 混合云与专线场景:业务流量固定走内网链路,避免绕行公网
  • 多地域部署:按业务所在地域配置对应接入点,降低调用延迟
  • 本地开发调试:开发机无内网时改用公网接入点并限制来源 IP
  • 故障排查:调用超时或证书错误时先确认解析到的接入点是否正确

接入点示例

接入点示例
阿里云 ECS(公网)   ecs.aliyuncs.com / ecs.cn-hangzhou.aliyuncs.com
阿里云 ECS(VPC)    ecs-vpc.cn-hangzhou.aliyuncs.com
腾讯云 CVM           cvm.tencentcloudapi.com(内网另有 internal 接入点)
华为云 ECS           ecs.cn-north-4.myhuaweicloud.com
# 命名规则各服务不同,以官方文档给出的接入点列表为准

常见现象与原因

现象常见原因处理方向
调用超时VPC 内解析不到该接入点确认内网 DNS 与接入点类型
签名或路由错误接入点地域与 region 参数不一致两者统一为同一地域
流量费用异常内网用了公网接入点绕行 NAT改用内网接入点
仅在生产偶发失败生产走内网、开发走公网,配置未区分配置按环境参数化
VPC 内调用优先使用内网接入点:不经过公网、不消耗公网流量,且时延更稳定;接入点与 region 参数要保持一致。
把接入点写死在代码里不利于多地域扩展:改为按地域与网络类型生成,或交由 SDK 的 region 参数推导。

易错点

  • VPC 内使用公网接入点,流量绕行 NAT 产生费用且链路更长
  • endpoint 地域与参数 region 不一致造成签名或路由错误
  • 接入点域名写死后只改 region 参数,实际请求仍打向原地域
  • 内网接入点未确认 DNS 可达就直接上线,表现为偶发超时而非稳定失败

数据来源与参考

  • 阿里云 服务接入点文档
  • 腾讯云 API 地域与接入点文档
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌