用途:该资料面向使用 Ruby 调用 Telnyx Networking 相关 API 的开发者,覆盖网络、网关和 Global IP 等资源的配置与管理,并提供 AI 聚类和集成接口示例。
安装与初始化:先执行 gem install telnyx 安装 SDK,再通过 require "telnyx" 引入,并使用 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 初始化客户端。API 密钥默认从环境变量读取。
主要能力:网络方面支持网络(networks)的列出、创建、检索、更新与删除,默认网关的查询、创建和删除,以及网络接口列表。私有无线网关支持列出与异步创建,需提供 network_id 和 name,可选 region_code,创建需数分钟。Global IP 模块提供 IP 列表、创建、检索与删除,以及分配、健康检查、允许端口、协议、延迟与用量等接口。AI 模块提供聚类(clusters)的列表、计算、检索、删除与可视化接口,以及集成的列表与连接管理。
错误处理:调用可能返回网络错误、限流 429、校验 422 或认证 401。示例中通过 rescue Telnyx::Errors::APIConnectionError、RateLimitError、APIStatusError 区分处理;429 建议配合 Retry-After 使用指数退避重试。分页使用 .auto_paging_each 自动遍历。
适用场景:适合需要在 Ruby 应用中自动化管理 Telnyx 私有网络、Global IP 与 WireGuard 相关资源配置的开发者。
限制:资料仅列出各接口的参数与返回字段,未提供具体价格、配额、速率上限数值或平台支持细节;部分接口(如私有无线网关检索)内容不完整。