SuperAPI AI 工具集

telnyx-storage-ruby

智能体与模型

查看项目

更新于 10-16 08:41

技能介绍

用途:该技能面向 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 方法生成。其余功能、收费与平台细节暂未提供。