kubernetes/kops · error

error listing %s: %v

Error message

error listing %s: %v

What it means

Returned in SwiftPath's directory-listing retry path when a Swift container listing call fails other than with not-found (404 becomes os.ErrNotExist). The list operation — fetching object names under a prefix — hit auth, permission, or transient proxy errors, so the child path list cannot be assembled and the backoff loop re-attempts it.

Source

Thrown at util/pkg/vfs/swiftfs.go:566

			if err1 != nil {
				return false, err1
			}
			for _, o := range objects {
				child := &SwiftPath{
					vfsContext: p.vfsContext,
					bucket:     p.bucket,
					key:        o.Name,
					hash:       o.Hash,
				}
				paths = append(paths, child)
			}

			return true, nil
		}); err != nil {
			if isSwiftNotFound(err) {
				return true, os.ErrNotExist
			}
			return false, fmt.Errorf("error listing %s: %v", p, err)
		}
		klog.V(8).Infof("Listed files in %v: %v", p, paths)
		ret = paths
		return true, nil
	})
	if err != nil {
		return nil, err
	} else if done {
		return ret, nil
	} else {
		return nil, wait.ErrWaitTimeout
	}
}

// ReadDir implements Path::ReadDir.
func (p *SwiftPath) ReadDir() ([]Path, error) {
	prefix := p.key
	if prefix != "" && !strings.HasSuffix(prefix, "/") {

View on GitHub (pinned to 4c8573c808)

Solutions

1. Check container list permissions for the configured tenant
2. Retry transient proxy failures; the backoff loop handles most throttling errors
3. Confirm the Swift endpoint in the catalog is correct and reachable

When it happens

Trigger: Thrown at util/pkg/vfs/swiftfs.go:566 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/c223b85834a153f0. Report an issue: GitHub.