帮你快速理解、总结文档立即下载
文档中心>智能媒资托管>SDK 文档>Go SDK>用量统计

用量统计

最近更新时间：2026-09-30 16:51:33
我的收藏

本页目录：

前期准备

开始操作前，确保您已经完成了 SDK 初始化。如果您还没有初始化 SDK，请先参考快速入门文档完成。

查询媒体库容量信息

功能说明
GetLibraryUsage 用于查询媒体库的容量信息，返回媒体库所有文件占用的存储额度。需要 admin 权限。
使用示例
ctx := context.Background()

resp, httpRes, err := apiClient.UsageAPI.GetLibraryUsage(ctx, "your-library-id").
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 {
    fmt.Printf("媒体库总用量: %s 字节\\n", *resp.TotalFileSize)
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
string
是
accessToken
访问令牌
string
否
librarySecret
访问媒体库密钥
string
否
userId
用户身份识别
string
否
返回值说明
HTTP 状态码：200，查询成功。
字段
说明
类型
totalFileSize
媒体库所有文件占用存储额度，单位字节（Byte），字符串格式
String

批量查询租户空间容量信息

功能说明
GetUsage 用于批量查询一个或多个租户空间的容量信息，包括配额、可用容量和已用容量。管理员可查询任意空间；space_admin 只能查询访问令牌所指定的空间。
使用示例
ctx := context.Background()

// 多个空间 ID 用英文逗号分隔，spaceIds 为路径参数
resp, httpRes, err := apiClient.UsageAPI.GetUsage(ctx, "your-library-id", "space1,space2").
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 {
    // 注意：返回的是数组指针
    for _, usage := range *resp {
        capacity := "无配额"
        if usage.Capacity.IsSet() && usage.Capacity.Get() != nil {
            capacity = *usage.Capacity.Get()
        }
        fmt.Printf("空间: %s, 配额: %s, 已用: %s 字节\\n",
            *usage.SpaceId, capacity, *usage.Size)
    }
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
string
是
spaceIds
租户空间 ID（路径参数），多个空间 ID 使用英文逗号（,）分隔
string
是
accessToken
访问令牌
string
否
librarySecret
访问媒体库密钥
string
否
userId
用户身份识别
string
否
返回值说明
HTTP 状态码：200，查询成功，返回空间容量信息数组（*[]GetUsage200ResponseInner）。
字段
说明
类型
spaceId
租户空间 ID
String
capacity
空间配额，单位字节（Byte），字符串格式；为 null 表示无配额（Go 中为 NullableString）
String
availableSpace
可用容量，单位字节（Byte），字符串格式；为 null 表示无配额（Go 中为 NullableString）
String
size
已上传文件占用额度，单位字节（Byte），字符串格式
String
中国站