帮你快速理解、总结文档立即下载
文档中心>智能媒资托管>SDK 文档>Java SDK>配额管理

配额管理

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

本页目录：

前期准备

开始操作前，确保您已经完成了 SDK 初始化。如果您还没有初始化 SDK，请先参考快速入门文档完成。
注意事项：
租户空间的剩余空间非实时更新，当系统负荷较高时可能会有比较大的更新延时，进而可能导致意外超出配额。
如果配置了超额自动删除选项，可能导致旧文件被删除。

创建配额

功能说明
createQuota 实现创建配额，用于为租户空间设置存储配额限制。支持为多个租户空间设置共享配额，并可配置超额自动删除策略。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.QuotaApi;
import com.tencent.cloud.smh.model.CreateQuotaRequest;
import com.tencent.cloud.smh.model.CreateQuota201Response;
import java.util.List;

CreateQuotaRequest quotaBody = new CreateQuotaRequest();
quotaBody.setCapacity("1099511627776"); // 1TB
quotaBody.setRemoveWhenExceed(true);
quotaBody.setRemoveAfterDays(30);
quotaBody.setRemoveNewest(false);
quotaBody.setSpaces(List.of("space1", "space2", "space3"));

try {
    QuotaApi.APICreateQuotaRequest request = QuotaApi.APICreateQuotaRequest.newBuilder()
        .libraryId("your-library-id")
        .accessToken("your-access-token")
        .userId("user-id")
        .createQuotaRequest(quotaBody)
        .build();

    ApiResponse<Object> apiResponse = client.quota().createQuotaWithHttpInfo(request);
    int statusCode = apiResponse.getStatusCode();
    System.out.println("Status code: " + statusCode);

    if (statusCode == 201) {
        CreateQuota201Response result = (CreateQuota201Response) apiResponse.getData();
        System.out.println("Quota created, ID: " + result.getQuotaId());
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
String
是
accessToken
访问令牌；对于公有读媒体库或租户空间可不指定，否则需通过本参数传入或提前调用 client.withToken() 注入，二者取一
String
否
userId
用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份
String
否
createQuotaRequest
创建配额请求对象
CreateQuotaRequest
是
CreateQuotaRequest 对象说明
字段
参数描述
类型
是否必填
spaces
对于多租户空间媒体库，指定配额所涵盖的租户空间，以便同时控制多个租户空间的配额，不支持传空数组；对于单租户空间，不能指定该字段
List<String>
否
capacity
配额的具体值，单位为字节（Byte），为了避免大数产生的精度损失，建议该字段指定为字符串形式
String
否
removeWhenExceed
当指定为 false 时，配额仅用于上传时判断是否有足够空间，对于已经超限的空间不执行任何删除清理操作；当指定为 true 时，创建配额将检查当前存储量，如果存储量已经超限，那么将在 removeAfterDays 天数到达后开始删除文件以保证存储量在配额之下，默认删除最早的文件，如果 removeNewest 指定为 true 则删除最新的文件
Boolean
是
removeAfterDays
存储量超限后在进行文件删除前等待的天数
Integer
是
removeNewest
是否从最新的文件开始删除，默认为 false，即从最旧的文件开始删除
Boolean
否
返回值说明
HTTP 状态码：201
创建成功，返回配额 ID。
响应字段说明
字段
说明
类型
quotaId
配额 ID，用于后续查询配额的具体信息、修改配额值或删除配额
Long

获取租户空间配额（按空间查询）

功能说明
getQuota 实现获取指定空间的配额信息，用于查询指定租户空间的配额详情。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.QuotaApi;
import com.tencent.cloud.smh.model.GetQuota200Response;

try {
    QuotaApi.APIGetQuotaRequest request = QuotaApi.APIGetQuotaRequest.newBuilder()
        .libraryId("your-library-id")
        .spaceId("your-space-id")
        .accessToken("your-access-token")
        .userId("user-id")
        .build();

    ApiResponse<Object> apiResponse = client.quota().getQuotaWithHttpInfo(request);
    int statusCode = apiResponse.getStatusCode();
    System.out.println("Status code: " + statusCode);

    if (statusCode == 200) {
        GetQuota200Response result = (GetQuota200Response) apiResponse.getData();
        System.out.println("Quota ID: " + result.getId());
        System.out.println("Capacity: " + result.getCapacity() + " bytes");
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
String
是
spaceId
空间 ID，如果媒体库为单租户模式，则该参数固定为连字符(-)；如果媒体库为多租户模式，则必须指定该参数
String
是
accessToken
访问令牌；对于公有读媒体库或租户空间可不指定，否则需通过本参数传入或提前调用 client.withToken() 注入，二者取一
String
否
userId
用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份
String
否
返回值说明
HTTP 状态码：200
获取成功，返回配额信息。
响应字段说明
字段
说明
类型
id
配额 ID
Long
capacity
配额的具体值，单位为字节（Byte），字符串格式
String

获取指定空间的配额信息

功能说明
getSpaceQuota 实现获取指定空间的配额信息，用于查询指定空间的配额使用详情。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.QuotaApi;
import com.tencent.cloud.smh.model.GetQuota200Response;

try {
    QuotaApi.APIGetSpaceQuotaRequest request = QuotaApi.APIGetSpaceQuotaRequest.newBuilder()
        .libraryId("your-library-id")
        .spaceId("your-space-id")
        .accessToken("your-access-token")
        .userId("user-id")
        .build();

    ApiResponse<Object> apiResponse = client.quota().getSpaceQuotaWithHttpInfo(request);
    int statusCode = apiResponse.getStatusCode();
    System.out.println("Status code: " + statusCode);

    if (statusCode == 200) {
        GetQuota200Response result = (GetQuota200Response) apiResponse.getData();
        System.out.println("Quota ID: " + result.getId());
        System.out.println("Capacity: " + result.getCapacity() + " bytes");
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
String
是
spaceId
空间 ID
String
是
accessToken
访问令牌；对于公有读媒体库或租户空间可不指定，否则需通过本参数传入或提前调用 client.withToken() 注入，二者取一
String
否
userId
用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份
String
否
返回值说明
HTTP 状态码：200
获取成功，返回配额信息。
响应字段说明
字段
说明
类型
id
配额 ID
Long
capacity
配额的具体值，单位为字节（Byte），字符串格式
String

获取租户配额信息

功能说明
getQuotaInfo 实现获取租户配额信息，用于根据配额 ID 查询配额的详细信息，包括配额涵盖的空间集合。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.QuotaApi;
import com.tencent.cloud.smh.model.GetQuotaInfo200Response;

try {
    QuotaApi.APIGetQuotaInfoRequest request = QuotaApi.APIGetQuotaInfoRequest.newBuilder()
        .libraryId("your-library-id")
        .quotaId("12345")
        .accessToken("your-access-token")
        .userId("user-id")
        .build();

    ApiResponse<Object> apiResponse = client.quota().getQuotaInfoWithHttpInfo(request);
    int statusCode = apiResponse.getStatusCode();
    System.out.println("Status code: " + statusCode);

    if (statusCode == 200) {
        GetQuotaInfo200Response result = (GetQuotaInfo200Response) apiResponse.getData();
        System.out.println("Quota capacity: " + result.getCapacity() + " bytes");
        System.out.println("Covered spaces: " + result.getSpaces().size());
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
String
是
quotaId
配额 ID
String
是
accessToken
访问令牌；对于公有读媒体库或租户空间可不指定，否则需通过本参数传入或提前调用 client.withToken() 注入，二者取一
String
否
userId
用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份
String
否
返回值说明
HTTP 状态码：200
获取成功，返回配额详细信息。
响应字段说明
字段
说明
类型
spaces
配额所使用的空间 ID 集合
List<String>
capacity
配额的具体值，单位为字节（Byte），字符串格式
String

修改配额

功能说明
updateQuota 实现修改配额，用于修改指定租户空间的配额设置。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.QuotaApi;
import com.tencent.cloud.smh.model.UpdateQuotaRequest;

UpdateQuotaRequest updateBody = new UpdateQuotaRequest();
updateBody.setCapacity("1099511627776"); // 1TB
updateBody.setRemoveWhenExceed(true);
updateBody.setRemoveAfterDays(30);
updateBody.setRemoveNewest(false);

try {
    QuotaApi.APIUpdateQuotaRequest request = QuotaApi.APIUpdateQuotaRequest.newBuilder()
        .libraryId("your-library-id")
        .spaceId("your-space-id")
        .accessToken("your-access-token")
        .userId("user-id")
        .updateQuotaRequest(updateBody)
        .build();

    ApiResponse<Object> apiResponse = client.quota().updateQuotaWithHttpInfo(request);
    System.out.println("Status code: " + apiResponse.getStatusCode());
    System.out.println("Quota updated successfully");
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
String
是
spaceId
空间 ID，如果媒体库为单租户模式，则该参数固定为连字符(-)；如果媒体库为多租户模式，则必须指定该参数
String
是
accessToken
访问令牌；对于公有读媒体库或租户空间可不指定，否则需通过本参数传入或提前调用 client.withToken() 注入，二者取一
String
否
userId
用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份
String
否
updateQuotaRequest
修改配额请求对象
UpdateQuotaRequest
是
UpdateQuotaRequest 对象说明
字段
参数描述
类型
是否必填
capacity
配额的具体值，单位为字节（Byte），为了避免大数产生的精度损失，建议该字段指定为字符串形式
String
是
removeWhenExceed
当指定为 false 时，配额仅用于上传时判断是否有足够空间，对于已经超限的空间不执行任何删除清理操作；当指定为 true 时，修改配额将检查当前存储量，如果存储量已经超限，那么将在 removeAfterDays 天数到达后开始删除文件以保证存储量在配额之下，默认删除最早的文件，如果 removeNewest 指定为 true 则删除最新的文件
Boolean
否
removeAfterDays
存储量超限后在进行文件删除前等待的天数
Integer
否
removeNewest
是否从最新的文件开始删除，默认为 false，即从最旧的文件开始删除
Boolean
否
返回值说明
HTTP 状态码：204
修改成功，无响应体。

根据配额 ID 修改配额

功能说明
updateQuotaById 实现根据配额 ID 修改配额，用于修改指定配额的设置。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.QuotaApi;
import com.tencent.cloud.smh.model.UpdateQuotaByIdRequest;
import java.util.List;

UpdateQuotaByIdRequest updateBody = new UpdateQuotaByIdRequest();
updateBody.setCapacity("1099511627776"); // 1TB
updateBody.setRemoveWhenExceed(true);
updateBody.setRemoveAfterDays(30);
updateBody.setRemoveNewest(false);
updateBody.setSpaces(List.of("space1", "space2"));

try {
    QuotaApi.APIUpdateQuotaByIdRequest request = QuotaApi.APIUpdateQuotaByIdRequest.newBuilder()
        .libraryId("your-library-id")
        .quotaId("12345")
        .accessToken("your-access-token")
        .userId("user-id")
        .updateQuotaByIdRequest(updateBody)
        .build();

    ApiResponse<Object> apiResponse = client.quota().updateQuotaByIdWithHttpInfo(request);
    System.out.println("Status code: " + apiResponse.getStatusCode());
    System.out.println("Quota updated by ID successfully");
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
String
是
quotaId
配额 ID，创建配额时会返回，也可以通过【获取租户空间配额】接口查询指定租户空间所在的配额 ID
String
是
accessToken
访问令牌；对于公有读媒体库或租户空间可不指定，否则需通过本参数传入或提前调用 client.withToken() 注入，二者取一
String
否
userId
用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份
String
否
updateQuotaByIdRequest
修改配额请求对象
UpdateQuotaByIdRequest
是
UpdateQuotaByIdRequest 对象说明
字段
参数描述
类型
是否必填
spaces
对于多租户空间媒体库，修改配额所涵盖的租户空间（暂不支持独立的增加或移除），以便同时控制多个租户空间的配额，不支持传空数组，如不指定该字段则不修改配额所涵盖的租户空间；对于单租户空间，不能指定该字段
List<String>
否
capacity
配额的具体值，单位为字节（Byte），为了避免大数产生的精度损失，建议该字段指定为字符串形式，如不指定则不修改配额的具体值
String
否
removeWhenExceed
当指定为 false 时，配额仅用于上传时判断是否有足够空间，对于已经超限的空间不执行任何删除清理操作；当指定为 true 时，修改配额将检查当前存储量，如果存储量已经超限，那么将在 removeAfterDays 天数到达后开始删除文件以保证存储量在配额之下，默认删除最早的文件，如果 removeNewest 指定为 true 则删除最新的文件，默认为 false
Boolean
否
removeAfterDays
存储量超限后在进行文件删除前等待的天数
Integer
否
removeNewest
是否从最新的文件开始删除，默认为 false，即从最旧的文件开始删除
Boolean
否
返回值说明
HTTP 状态码：204
修改成功，无响应体。
中国站