{"record":{"id":"d527ef4a02ddaf20","repo":"kubernetes/kops","slug":"volumethroughput-to-volumeiops-ratio-must-be-lower","errorCode":null,"errorMessage":"volumeThroughput to volumeIops ratio must be lower than 0.25. For %s ratio is %.02f","messagePattern":"volumeThroughput to volumeIops ratio must be lower than 0\\.25\\. For (.+?) ratio is %\\.02f","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/model/master_volumes.go","lineNumber":231,"sourceCode":"\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 {\n\t\tname = name[:64]\n\t}\n\n\ttags := make(map[string]string)\n\ttags[do.TagNameEtcdClusterPrefix+etcd.Name] = do.SafeClusterName(m.Name)\n\ttags[do.TagKubernetesClusterIndex] = do.SafeClusterName(m.Name)\n","sourceCodeStart":213,"sourceCodeEnd":249,"githubUrl":"https://github.com/kubernetes/kops/blob/4c8573c808a73d578c5eadc86d410646ea0b0d73/pkg/model/master_volumes.go#L213-L249","documentation":"Preflight validation in validateAWSVolume for gp3 volumes: AWS caps throughput at 0.25 MiB/s per provisioned IOPS. The computed volumeThroughput/volumeIops ratio exceeded 0.25, so the gp3 volume configuration is rejected locally before any AWS API call.","triggerScenarios":"Thrown at pkg/model/master_volumes.go:231 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Raise volumeIOPS so throughput/iops <= 0.25","Lower the configured volume throughput","Review etcdVolumeIOPS/throughput settings for the etcd member"],"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-12T07:17:12.445Z"}