用途:通过 Telnyx Storage 的 S3 兼容 API,在 Java 项目中管理云存储桶与对象,资料以 Java SDK 示例形式提供。
安装:Maven 添加依赖 com.telnyx.sdk:telnyx:6.89.0;Gradle 使用 implementation("com.telnyx.sdk:telnyx:6.89.0")。
初始化:TelnyxClient client = TelnyxOkHttpClient.fromEnv();
主要能力(均为资料列出的接口):
- 桶 SSL 证书:GET/PUT/DELETE /storage/buckets/{bucketName}/ssl_certificate,用于查询、上传与删除证书,便于将 Telnyx 存储用作 CDN,返回 created_at、id、issued_by、issued_to、valid_from、valid_to。
- 用量查询:GET /storage/buckets/{bucketName}/usage/api 按时间段与方法类别返回 API 用量;GET /storage/buckets/{bucketName}/usage/storage 返回存储空间与文件数,含 num_objects、size、size_kb、timestamp。
- 预签名 URL:POST /storage/buckets/{bucketName}/{objectName}/presigned_url,可带可选 ttl,返回带时效与鉴权的下载(GET)或上传(PUT)地址。
错误处理:可能遇到 401、403、404、422、429。捕获 TelnyxServiceException,按状态码处理,429 建议退避重试。
限制:预签名 URL 必须使用 Telnyx 自身方式生成,不得使用 AWS s3api CLI 或 SDK 的 presign 方法,因为鉴权方式与 AWS S3 不同。其余接口细节、定价与配额资料未提供。