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 参数推导。