用途:该技能面向 Ruby 开发者,演示如何使用 Telnyx Storage 的 S3 兼容 API 管理云存储桶与对象。
安装与初始化:使用 gem install telnyx 安装,然后通过 require "telnyx" 引入,并用 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 创建客户端。
主要能力:
- SSL 证书管理:GET/PUT/DELETE /storage/buckets/{bucketName}/ssl_certificate,用于获取、上传(配合密钥,可将 Telnyx 存储用作 CDN)和删除证书。
- 用量查询:GET /storage/buckets/{bucketName}/usage/api 按方法类别返回指定时间段 API 用量;GET /storage/buckets/{bucketName}/usage/storage 返回存储空间与文件数量。
- 预签名 URL:POST /storage/buckets/{bucketName}/{objectName}/presigned_url,生成带时效的下载(GET)或上传(PUT)认证 URL,可选 ttl 参数。
错误处理:需处理网络错误、429 限流、422 校验错误和 401 认证错误;常见状态码包括 401、403、404、422、429,限流建议指数退避重试。
限制:预签名 URL 的认证方式与 AWS S3 不同,不能使用 AWS s3api CLI 或 SDK 的 presign 方法生成。其余功能、收费与平台细节暂未提供。