Telnyx Networking - Go 是 Telnyx 官方技能仓库 team-telnyx/telnyx-skills 中的一个技能,面向使用 Go 语言调用 Telnyx Networking 相关 API 的开发者。它提供 Go SDK 示例,用于配置私有网络、WireGuard VPN 网关、互联网网关和虚拟交叉连接。
安装方式为执行 go get github.com/team-telnyx/telnyx-go。初始化客户端时导入 github.com/team-telnyx/telnyx-go 与 github.com/team-telnyx/telnyx-go/option,并通过 option.WithAPIKey(os.Getenv("TELNYX_API_KEY")) 传入 API Key。文档中的示例均假设 client 已按此方式初始化。
错误处理方面,所有 API 调用都可能因网络错误、限流(429)、校验错误(422)或认证错误(401)而失败。示例建议在生产代码中始终处理错误,并给出常见错误码说明:401 表示 API Key 无效,403 表示权限不足,404 表示资源未找到,422 表示校验错误(需检查字段格式),429 表示被限流(建议使用指数退避重试)。分页可使用 ListAutoPaging() 自动迭代。
主要能力覆盖以下 API 分组:AI 集群(列出、计算、获取、删除集群以及获取集群可视化图)、AI 集成(列出可用集成、列出用户集成连接、按 ID 获取或删除连接、按 ID 获取集成详情)、Global IP 允许端口、Global IP 分配健康检查指标、Global IP 分配(列出、创建、获取、更新、删除)、Global IP 分配用量指标、Global IP 健康检查类型、Global IP 健康检查(列出、创建、获取、删除)、Global IP 延迟指标、Global IP 协议、Global IP 用量指标、Global IP(列出、创建、获取、删除)以及网络(列出、创建、获取)。
使用方式上,每个接口都给出对应的 HTTP 方法与路径,例如 GET /networks、POST /networks、GET /networks/{id},并附带 Go 调用示例与返回字段说明。例如创建网络需要 name 必填参数;创建 Global IP 分配、健康检查等接口列出了可选字段;AI 集群计算接口需要 bucket 必填,可选 files、min_cluster_size、min_subcluster_size、prefix。
适用场景包括:在 Go 应用中管理 Telnyx 私有网络与 Global IP 资源、配置 WireGuard 相关分配、查询网络与 IP 的用量、延迟和健康检查指标,以及使用 AI 集群与集成接口。限制方面,资料未提供收费、价格、平台支持范围或具体效果等信息,暂未提供;实际使用需自行准备 TELNYX_API_KEY 并处理 API 错误与限流。