用途:本技能面向使用 Telnyx Networking 能力的 Python 开发者,提供私有网络(Networks)、WireGuard VPN 网关、互联网网关、虚拟交叉连接以及 Global IP 相关资源的 SDK 调用示例,用于通过代码管理这些网络资源。
安装与初始化:通过 pip install telnyx 安装,使用 from telnyx import Telnyx 创建客户端(client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))),后续示例均假设 client 已按此方式初始化。
主要能力:资料覆盖网络(networks)的增删改查、默认网关(default_gateway)的查询/创建/删除、网络接口列表;Global IP 及其分配、健康检查、协议、允许端口、用量与延迟等指标;以及 AI 聚类与集成相关的接口(如 client.ai.clusters、client.ai.integrations)。列表方法返回自动分页迭代器,可用 for item in page_result 遍历全部页。
错误处理:API 调用可能因网络错误、限流(429)、校验错误(422)或认证错误(401)失败,示例给出 telnyx.APIConnectionError、telnyx.RateLimitError、telnyx.APIStatusError 的捕获方式,并建议 429 时按 Retry-After 或指数退避重试,422 时检查必填字段与格式。
限制:资料仅为 SDK 用法示例,未提供价格、计费、平台覆盖、性能或效果数据;部分接口的完整参数与返回结构以 API 文档为准,此处未提供。