{"record":{"id":"305f62639310cf53","repo":"kubernetes/kops","slug":"volumeiops-to-volumesize-ratio-must-be-lower-than","errorCode":null,"errorMessage":"volumeIops to volumeSize ratio must be lower than 50. For %s ratio is %.02f","messagePattern":"volumeIops to volumeSize ratio must be lower than 50\\. For (.+?) ratio is %\\.02f","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/model/master_volumes.go","lineNumber":220,"sourceCode":"\tcase ec2types.VolumeTypeGp3:\n\t\tt.VolumeThroughput = new(int32(volumeThroughput))\n\t\tfallthrough\n\tcase ec2types.VolumeTypeIo1, ec2types.VolumeTypeIo2:\n\t\tt.VolumeIops = new(int32(volumeIops))\n\t}\n\n\tc.AddTask(t)\n\n\treturn nil\n}\n\nfunc validateAWSVolume(name, volumeType string, volumeSize, volumeIops, volumeThroughput int32) error {\n\tvolumeIopsSizeRatio := float64(volumeIops) / float64(volumeSize)\n\tvolumeThroughputIopsRatio := float64(volumeThroughput) / float64(volumeIops)\n\tswitch ec2types.VolumeType(volumeType) {\n\tcase ec2types.VolumeTypeIo1:\n\t\tif volumeIopsSizeRatio > 50.0 {\n\t\t\treturn fmt.Errorf(\"volumeIops to volumeSize ratio must be lower than 50. For %s ratio is %.02f\", name, volumeIopsSizeRatio)\n\t\t}\n\tcase ec2types.VolumeTypeIo2:\n\t\tif volumeIopsSizeRatio > 500.0 {\n\t\t\treturn fmt.Errorf(\"volumeIops to volumeSize ratio must be lower than 500. For %s ratio is %.02f\", name, volumeIopsSizeRatio)\n\t\t}\n\tcase ec2types.VolumeTypeGp3:\n\t\tif volumeIops > 3000 && volumeIopsSizeRatio > 500.0 {\n\t\t\treturn fmt.Errorf(\"volumeIops to volumeSize ratio must be lower than 500. For %s ratio is %.02f\", name, volumeIopsSizeRatio)\n\t\t}\n\t\tif volumeThroughputIopsRatio > 0.25 {\n\t\t\treturn fmt.Errorf(\"volumeThroughput to volumeIops ratio must be lower than 0.25. For %s ratio is %.02f\", name, volumeThroughputIopsRatio)\n\t\t}\n\t}\n\treturn nil\n}\n\nfunc (b *MasterVolumeBuilder) addDOVolume(c *fi.CloudupModelBuilderContext, name string, volumeSize int32, zone string, etcd kops.EtcdClusterSpec, m kops.EtcdMemberSpec, allMembers []string) {\n\t// required that names start with a lower case and only contains letters, numbers and hyphens","sourceCodeStart":202,"sourceCodeEnd":238,"githubUrl":"https://github.com/kubernetes/kops/blob/4c8573c808a73d578c5eadc86d410646ea0b0d73/pkg/model/master_volumes.go#L202-L238","documentation":"A preflight validation inside validateAWSVolume: for io1 EBS volumes, AWS caps provisioned IOPS at 50x the volume size in GiB. The computed volumeIops/volumeSize ratio exceeded that limit, so the etcd/control-plane volume task is rejected before any AWS call is made.","triggerScenarios":"Thrown at pkg/model/master_volumes.go:220 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Increase volumeSize so that iops/size <= 50","Lower the etcdVolumeIOPS setting on the etcd cluster member","Switch to io2 (500:1 ratio) or gp3 if higher IOPS density is needed"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"4c8573c808a73d578c5eadc86d410646ea0b0d73","analyzedAt":"2026-09-05T04:13:19.212Z","contentChangedAt":"2026-09-05T04:13:19.212Z","schemaVersion":2},"datasetVersion":"2026-09-12T12:17:11.808Z"}