{"record":{"id":"cbe763bdc8bceb6f","repo":"kubernetes/kops","slug":"volumeiops-to-volumesize-ratio-must-be-lower-than-cbe763","errorCode":null,"errorMessage":"volumeIops to volumeSize ratio must be lower than 500. For %s ratio is %.02f","messagePattern":"volumeIops to volumeSize ratio must be lower than 500\\. For (.+?) ratio is %\\.02f","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/model/master_volumes.go","lineNumber":224,"sourceCode":"\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\n\tname = \"kops-\" + do.SafeClusterName(name)\n\n\t// DO has a 64 character limit for volume names\n\tif len(name) >= 64 {","sourceCodeStart":206,"sourceCodeEnd":242,"githubUrl":"https://github.com/kubernetes/kops/blob/4c8573c808a73d578c5eadc86d410646ea0b0d73/pkg/model/master_volumes.go#L206-L242","documentation":"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.","triggerScenarios":"Thrown at pkg/model/master_volumes.go:224 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Increase the etcd member's volume size until ratio <= 500","Reduce the configured IOPS for the io2 volume","Verify the etcdVolumeSize/etcdVolumeIOPS settings are in GiB/IOPS units as expected"],"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"}