alibaba/nacos · error · NacosApiException

10000

10000

Error message

At least one of the parameters (groupName or namespaceId) must be provided

What it means

Error "At least one of the parameters (groupName or namespaceId) must be provided" thrown in alibaba/nacos.

Source

Thrown at config/src/main/java/com/alibaba/nacos/config/server/controller/v3/CapacityControllerV3.java:75

    private static final Logger LOGGER = LoggerFactory.getLogger(CapacityControllerV3.class);
    
    private final CapacityService capacityService;
    
    public CapacityControllerV3(CapacityService capacityService) {
        this.capacityService = capacityService;
    }
    
    /**
     * Get capacity information.
     */
    @Since("3.0.0")
    @GetMapping
    @Secured(resource = Constants.CAPACITY_CONTROLLER_V3_ADMIN_PATH, action = ActionTypes.READ,
        signType = SignType.CONSOLE, apiType = ApiType.ADMIN_API)
    public Result<Capacity> getCapacity(@RequestParam(required = false) String groupName,
        @RequestParam(required = false) String namespaceId) throws NacosApiException {
        if (StringUtils.isBlank(groupName) && StringUtils.isBlank(namespaceId)) {
            throw new NacosApiException(HttpStatus.BAD_REQUEST.value(), ErrorCode.PARAMETER_MISSING,
                "At least one of the parameters (groupName or namespaceId) must be provided");
        }
        
        try {
            Capacity capacity = capacityService.getCapacityWithDefault(groupName, namespaceId);
            if (capacity == null) {
                LOGGER.warn(
                    "[getCapacity] capacity not exist，need init groupName: {}, namespaceId: {}",
                    groupName,
                    namespaceId);
                capacityService.initCapacity(groupName, namespaceId);
                capacity = capacityService.getCapacityWithDefault(groupName, namespaceId);
            }
            return Result.success(capacity);
        } catch (Exception e) {
            LOGGER.error(
                "[getCapacity] Failed to fetch capacity for groupName: {}, namespaceId: {}",
                groupName,

View on GitHub (pinned to 9b989acdf1)

Solutions

1. Correct the invalid value for capacity query parameters to match the expected format or allowed set, then retry.

When it happens

Trigger: Thrown at config/src/main/java/com/alibaba/nacos/config/server/controller/v3/CapacityControllerV3.java:75 when the library encounters an invalid state.

Common situations: Calling the capacity API without groupName or namespaceId.

AI-assisted analysis of alibaba/nacos@9b989acdf1 (2026-08-14). Data as JSON: /api/errors/ab3e59baa497b48f. Report an issue: GitHub.