All Products
Search

This Product

    Container Service for Kubernetes:Cloud disk FAQ

    Document Center

    Container Service for Kubernetes:Cloud disk FAQ

    Last Updated:Mar 26, 2026

    This topic covers common errors when creating dynamically provisioned disk volumes in ACK Serverless clusters and how to fix them.

    Run the following command to view persistent volume claim (PVC) events, then match your error to one of the sections below:

    kubectl describe pvc <pvc-name>

    FAQ about disk creation

    Why does PVC provisioning fail with InvalidDataDiskCatagory.NotSupported?

    The zone either does not support the disk type specified in your StorageClass, or that disk type is out of stock there. Use one of the following solutions:

    • Specify multiple disk types in your StorageClass. The Container Storage Interface (CSI) plug-in selects an available type automatically. See Use a dynamically provisioned disk volume for configuration details. You can also update the CSI plug-in to the latest version and use the alicloud-disk-topology-alltype StorageClass, which handles multi-type selection automatically. Use this option when you want to stay in the same zone.

    • Add nodes in a different zone. If your workload can tolerate zone flexibility, expanding to another zone resolves both availability and stock issues. See Recommended storage settings for cross-zone deployment. Use this option when zone flexibility is acceptable and the current zone has persistent stock issues.

    Why does PVC provisioning fail with "The specified AZone inventory is insufficient"?

    The underlying Elastic Compute Service (ECS) instances needed to back the disk are out of stock in the zone. Use one of the following solutions:

    • Specify multiple disk types in your StorageClass. Update the CSI plug-in to the latest version and use the alicloud-disk-topology-alltype StorageClass so the CSI plug-in can fall back to an available type. See Use a dynamically provisioned disk volume. Use this option when you want to stay in the same zone.

    • Add nodes in a different zone. Move provisioning to a zone with available inventory. See Recommended storage settings for cross-zone deployment. Use this option when zone flexibility is acceptable.

    Why does PVC provisioning fail with "disk size is not supported"?

    The disk size specified in your PVC does not meet the minimum for the disk type. For example, ultra disks and SSDs require at least 20 GiB. Check the limits for your disk type in Disk categories, then update the storage request in your PVC to meet the requirement.

    Why does persistent volume (PV) creation fail in WaitForFirstConsumer mode but work in Immediate mode?

    In ACK Serverless clusters, nodes are allocated at pod scheduling time rather than in advance. Because the cluster does not know which zone to provision the disk in until a pod claims the PVC, WaitForFirstConsumer mode requires additional configuration to correctly detect the scheduling topology.

    To enable WaitForFirstConsumer mode in ACK Serverless:

    1. Update csi-provisioner to the latest version. See Manage components.

    2. Edit the eci-profile ConfigMap:

      kubectl edit configmap eci-profile -n kube-system

    3. In the featureGates section, set WaitForFirstConsumer to true:

      featureGates: MetricsVpcNet=true,WaitForFirstConsumer=true