kubernetes/kops · error

error describing volumes: %v

Error message

error describing volumes: %v

What it means

The paginated EC2 DescribeVolumes call failed while findEtcdStatus searched for etcd volumes by cluster tags. Fires on API errors, throttling, or missing ec2:DescribeVolumes permission, aborting cluster status discovery.

Source

Thrown at upup/pkg/fi/cloudup/awsup/status.go:75

// findEtcdStatus discovers the status of etcd, by looking for the tagged etcd volumes
func findEtcdStatus(c AWSCloud, cluster *kops.Cluster) ([]kops.EtcdClusterStatus, error) {
	klog.V(2).Infof("Querying AWS for etcd volumes")
	statusMap := make(map[string]*kops.EtcdClusterStatus)

	tags := c.Tags()

	request := &ec2.DescribeVolumesInput{}
	for k, v := range tags {
		request.Filters = append(request.Filters, NewEC2Filter("tag:"+k, v))
	}

	var volumes []ec2types.Volume
	klog.V(2).Infof("Listing EC2 Volumes")
	paginator := ec2.NewDescribeVolumesPaginator(c.EC2(), request)
	for paginator.HasMorePages() {
		page, err := paginator.NextPage(context.TODO())
		if err != nil {
			return nil, fmt.Errorf("error describing volumes: %v", err)
		}
		volumes = append(volumes, page.Volumes...)
	}

	var err error
	for _, volume := range volumes {
		volumeID := aws.ToString(volume.VolumeId)

		etcdClusterName := ""
		var etcdClusterSpec *etcd.EtcdClusterSpec
		master := false
		for _, tag := range volume.Tags {
			k := aws.ToString(tag.Key)
			v := aws.ToString(tag.Value)

			if strings.HasPrefix(k, TagNameEtcdClusterPrefix) {
				etcdClusterName = strings.TrimPrefix(k, TagNameEtcdClusterPrefix)
				etcdClusterSpec, err = etcd.ParseEtcdClusterSpec(etcdClusterName, v)

View on GitHub (pinned to 4c8573c808)

Solutions

1. Verify ec2:DescribeVolumes permission
2. Retry the kops operation (e.g. 'kops validate cluster') after transient failures
3. Check the wrapped error for throttling and back off

When it happens

Trigger: Thrown at upup/pkg/fi/cloudup/awsup/status.go:75 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/7ef6254004f3dca1. Report an issue: GitHub.