用途:通过 REST API(curl)管理 Telnyx Storage 的存储桶与对象,适用于脚本、命令行和轻量集成场景。
主要能力(据资料):获取/上传/删除存储桶 SSL 证书;查询桶的 API 用量(按时间段、方法类别分组);查询桶的存储用量与对象数量;生成限时认证的对象预签名 URL(下载 GET 或上传 PUT)。
使用方式:curl 已预装于 macOS、Linux、Windows 10+。先设置 export TELNYX_API_KEY="YOUR_API_KEY_HERE",请求时带 Authorization: Bearer $TELNYX_API_KEY。示例接口:GET 获取证书 /storage/buckets/{bucketName}/ssl_certificate;PUT 上传证书需 -F "certificate=@/path/to/file" -F "private_key=@/path/to/file";DELETE 删除证书。用量:GET /storage/buckets/{bucketName}/usage/api(可带 filter 的 start_time/end_time)、GET /storage/buckets/{bucketName}/usage/storage。预签名:POST /storage/buckets/{bucketName}/{objectName}/presigned_url,可选 ttl,返回 content 对象。
限制与注意:预签名 URL 认证方式与 AWS S3 不同,不得用 AWS s3api CLI 或 SDK 的 presign 方法生成;接口可能返回 401、403、404、422、429 等错误,生产代码需处理网络错误、限流(429 建议延迟重试)与校验错误(422 检查字段格式)。文档未提供价格、速率上限、平台覆盖面等信息。