kubernetes/kops · error

volumeIops to volumeSize ratio must be lower than 500. For %

Error message

volumeIops to volumeSize ratio must be lower than 500. For %s ratio is %.02f

What it means

Preflight validation in validateAWSVolume for io2 EBS volumes: AWS permits at most 500 IOPS per GiB. The computed volumeIops/volumeSize ratio exceeded 500, so the volume task is rejected before provisioning.

Source

Thrown at pkg/model/master_volumes.go:224

		t.VolumeIops = new(int32(volumeIops))
	}

	c.AddTask(t)

	return nil
}

func validateAWSVolume(name, volumeType string, volumeSize, volumeIops, volumeThroughput int32) error {
	volumeIopsSizeRatio := float64(volumeIops) / float64(volumeSize)
	volumeThroughputIopsRatio := float64(volumeThroughput) / float64(volumeIops)
	switch ec2types.VolumeType(volumeType) {
	case ec2types.VolumeTypeIo1:
		if volumeIopsSizeRatio > 50.0 {
			return fmt.Errorf("volumeIops to volumeSize ratio must be lower than 50. For %s ratio is %.02f", name, volumeIopsSizeRatio)
		}
	case ec2types.VolumeTypeIo2:
		if volumeIopsSizeRatio > 500.0 {
			return fmt.Errorf("volumeIops to volumeSize ratio must be lower than 500. For %s ratio is %.02f", name, volumeIopsSizeRatio)
		}
	case ec2types.VolumeTypeGp3:
		if volumeIops > 3000 && volumeIopsSizeRatio > 500.0 {
			return fmt.Errorf("volumeIops to volumeSize ratio must be lower than 500. For %s ratio is %.02f", name, volumeIopsSizeRatio)
		}
		if volumeThroughputIopsRatio > 0.25 {
			return fmt.Errorf("volumeThroughput to volumeIops ratio must be lower than 0.25. For %s ratio is %.02f", name, volumeThroughputIopsRatio)
		}
	}
	return nil
}

func (b *MasterVolumeBuilder) addDOVolume(c *fi.CloudupModelBuilderContext, name string, volumeSize int32, zone string, etcd kops.EtcdClusterSpec, m kops.EtcdMemberSpec, allMembers []string) {
	// required that names start with a lower case and only contains letters, numbers and hyphens
	name = "kops-" + do.SafeClusterName(name)

	// DO has a 64 character limit for volume names
	if len(name) >= 64 {

View on GitHub (pinned to 4c8573c808)

Solutions

1. Increase the etcd member's volume size until ratio <= 500
2. Reduce the configured IOPS for the io2 volume
3. Verify the etcdVolumeSize/etcdVolumeIOPS settings are in GiB/IOPS units as expected

When it happens

Trigger: Thrown at pkg/model/master_volumes.go:224 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of kubernetes/kops@4c8573c808 (2026-09-05). Data as JSON: /api/errors/cbe763bdc8bceb6f. Report an issue: GitHub.