用途:该技能用 Java SDK 调用 S3 兼容的 Telnyx Storage API,管理云端存储桶与对象,适合在 Java 项目中集成 Telnyx 云存储功能。
安装:Maven 添加依赖 com.telnyx.sdk:telnyx:6.36.0;Gradle 使用 implementation("com.telnyx.sdk:telnyx:6.36.0")。
初始化:通过 TelnyxOkHttpClient.fromEnv() 创建 TelnyxClient,示例均假设已完成该初始化。
主要能力:查询存储桶 SSL 证书(GET /storage/buckets/{bucketName}/ssl_certificate);上传 SSL 证书及匹配密钥以将 Telnyx 存储用作 CDN(PUT 同路径);删除 SSL 证书及密钥(DELETE 同路径);按方法类别查询某时间段存储桶 API 用量(GET .../usage/api);查询存储桶存储空间与文件数量(GET .../usage/storage);生成带时效的鉴权 URL 用于下载(GET)或上传(PUT)对象(POST /storage/buckets/{bucketName}/{objectName}/presigned_url,可选 ttl)。
错误处理:网络错误、限流 429、校验错误 422、认证错误 401 等需处理;常见错误码 401 密钥无效、403 权限不足、404 资源不存在、422 字段格式校验失败、429 限流(建议指数退避重试)。
限制:预签名 URL 的认证方式不同于 AWS S3,禁止使用 AWS s3api CLI 或 SDK 的 presign 方法生成,需参考官方文档 https://developers.telnyx.com/docs/cloud-storage/presigned-urls。其他细节资料暂未提供。