Telnyx Storage - Ruby 是一个面向 Ruby 开发者的技能，用于通过兼容 S3 的 Telnyx Storage API 管理云存储桶和对象。该技能以 Ruby SDK 示例的形式提供，帮助开发者在 Ruby 项目中集成 Telnyx 的云存储能力。
用途 该技能主要用于在 Ruby 环境中操作 Telnyx Storage，包括管理存储桶的 SSL 证书、查询 API 与存储用量，以及生成用于上传或下载对象的预签名 URL。
安装与初始化 安装命令为：gem install telnyx。初始化客户端时使用 Telnyx::Client.new，并通过 ENV["TELNYX_API_KEY"] 传入 API 密钥（该参数为默认值，可省略）。后续所有示例均假设客户端已按此方式初始化。
错误处理 所有 API 调用都可能因网络错误、速率限制（429）、验证错误（422）或认证错误（401）而失败。生产代码中应始终处理错误。示例中捕获了 Telnyx::Errors::APIConnectionError（网络错误，建议检查连接并重试）、Telnyx::Errors::RateLimitError（429，建议等待并使用指数退避重试，可查看 Retry-After 头获取实际延迟）以及 Telnyx::Errors::APIStatusError（输出状态码与消息，422 时提示检查必填字段与格式）。常见错误码包括：401 无效 API 密钥、403 权限不足、404 资源未找到、422 验证错误、429 速率限制。
主要能力
- 获取存储桶 SSL 证书：GET /storage/buckets/{bucketName}/ssl_certificate，返回 created_at、id、issued_by、issued_to、valid_from、valid_to。
- 添加 SSL 证书：PUT /storage/buckets/{bucketName}/ssl_certificate，上传 SSL 证书及其匹配密钥，以便将 Telnyx 存储用作 CDN，返回字段同上。
- 删除 SSL 证书：DELETE /storage/buckets/{bucketName}/ssl_certificate，删除 SSL 证书及其匹配密钥，返回字段同上。
- 获取 API 用量：GET /storage/buckets/{bucketName}/usage/api，按方法类别分组返回特定时间段内存储桶的 API 用量详情，支持 filter 参数（end_time、start_time），返回 categories、timestamp、total。
- 获取存储桶用量：GET /storage/buckets/{bucketName}/usage/storage，返回存储桶占用的存储空间和文件数量，返回 num_objects、size、size_kb、timestamp。
- 创建预签名对象 URL：POST /storage/buckets/{bucketName}/{objectName}/presigned_url，返回带时效和认证的 URL，用于下载（GET）或上传（PUT）对象，相当于 AWS S3 的“presigned” URL。可选参数 ttl（整数）。需注意 Telnyx 的认证方式与 AWS S3 不同，不得使用 AWS s3api CLI 或 SDK 的 presign 方法生成预签名 URL。参考文档：https://developers.telnyx.com/docs/cloud-storage/presigned-urls。返回 content。
使用方式 开发者需先安装 telnyx gem 并初始化客户端，然后按需调用上述方法。示例代码中展示了各接口的调用形式与返回字段。
适用场景 适用于需要在 Ruby 应用中管理 Telnyx 云存储桶、配置 SSL 证书以使用 CDN、监控 API 与存储用量，以及生成预签名 URL 进行对象上传下载的场景。
限制 该技能仅提供 Ruby SDK 示例，未提供其他语言示例。预签名 URL 必须使用 Telnyx 自身方式生成，不能使用 AWS S3 工具。其他功能、收费、价格、平台或效果信息暂未提供。