用途:该技能面向 Telnyx Storage,用 JavaScript SDK 管理云存储桶与对象,基于兼容 S3 的 Telnyx Storage API,提供 JavaScript 示例。
安装与初始化:npm install telnyx@6.74.2;随后 import Telnyx from 'telnyx',并用 new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] }) 创建 client。后续示例均假设 client 已初始化。
主要能力:包含桶 SSL 证书的获取(GET /storage/buckets/{bucketName}/ssl_certificate)、上传(PUT,用于将存储作为 CDN)、删除(DELETE);API 使用量查询(GET /storage/buckets/{bucketName}/usage/api,可按时间段与 method 类别分组);桶用量查询(GET /storage/buckets/{bucketName}/usage/storage,返回对象数、大小等);以及创建预签名对象 URL(POST /storage/buckets/{bucketName}/{objectName}/presigned_url,可选 ttl),用于限时认证的下载(GET)或上传(PUT)。
错误处理:调用可能因网络、限流(429)、校验(422)或鉴权(401)失败。示例区分 Telnyx.APIConnectionError、Telnyx.RateLimitError(可读取 retry-after 后指数退避重试)与 Telnyx.APIError,并提示 401、403、404、422、429 等常见状态码含义。
限制:预签名 URL 必须使用 Telnyx 自身方法生成,不能使用 AWS s3api CLI 或 SDK 的 presign,因为 Telnyx 的鉴权方式与 AWS S3 不同。资料未提供价格、配额或平台支持等更多说明。