telnyx-storage-python

用途：本技能通过 Telnyx Python SDK 管理云存储桶与对象，使用兼容 S3 的 Telnyx Storage API，提供可直接参考的 Python 代码示例。

安装与初始化：安装命令为 pip install telnyx。初始化时从环境变量读取密钥，示例：client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))。

主要能力：

1. 获取桶 SSL 证书（GET /storage/buckets/{bucketName}/ssl_certificate）；
2. 上传 SSL 证书及配套密钥，将 Telnyx 存储用作 CDN（PUT 同路径）；
3. 删除 SSL 证书及密钥（DELETE 同路径）；
4. 按时间段和请求方法类别查询桶的 API 使用情况（GET /storage/buckets/{bucketName}/usage/api），需传入 filter 的 start_time 与 end_time；
5. 查询桶的存储空间和文件数量（GET /storage/buckets/{bucketName}/usage/storage）；
6. 生成有时效的预签名对象 URL，用于下载（GET）或上传（PUT）（POST /storage/buckets/{bucketName}/{objectName}/presigned_url），可选 ttl 参数。

错误处理：建议在生产代码中捕获 telnyx.APIConnectionError（网络错误）、telnyx.RateLimitError（429，建议按 Retry-After 指数退避重试）与 telnyx.APIStatusError（含 401、403、404、422 等状态码）。

限制与注意：预签名 URL 必须通过 Telnyx 的 presign 方式生成，不能使用 AWS s3api CLI 或 SDK 的 presign 方法，因为 Telnyx 的认证方式与 AWS S3 不同。资料未提供计费、价格或配额信息。