hashicorp/nomad · error

Error fetching deployments for job %s: %v

Error message

Error fetching deployments for job %s: %v

What it means

fetchRegionDeployment queries c.Jobs().Deployments for the job in a specific region. Any transport/API error from that call is wrapped as "Error fetching deployments for job %s: %v", keeping the job ID for context.

Source

Thrown at command/deployment_status.go:636

			key := fmt.Sprintf("%s (error)", res.region)
			results[key] = &api.Deployment{}
			continue
		}
		results[res.region] = res.d

	}
	return results, nil
}

func fetchRegionDeployment(c *api.Client, d *api.Deployment, region *api.MultiregionRegion) (*api.Deployment, error) {
	if region == nil {
		return nil, errors.New("Region not found")
	}

	opts := &api.QueryOptions{Region: region.Name}
	deploys, _, err := c.Jobs().Deployments(d.JobID, false, opts)
	if err != nil {
		return nil, fmt.Errorf("Error fetching deployments for job %s: %v", d.JobID, err)
	}
	for _, dep := range deploys {
		if dep.JobVersion == d.JobVersion {
			return dep, nil
		}
	}
	return nil, fmt.Errorf("Could not find job version %d for region", d.JobVersion)
}

func formatMultiregionDeployment(regions map[string]*api.Deployment, uuidLength int) string {
	rowString := "Region|ID|Status"
	rows := make([]string, len(regions)+1)
	rows[0] = rowString
	i := 1
	for k, v := range regions {
		row := fmt.Sprintf("%s|%s|%s", k, limit(v.ID, uuidLength), v.Status)
		rows[i] = row
		i++

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Inspect the wrapped cause — for connection errors check that region's agent availability/federation
2. Verify the ACL token grants read access in every region the job targets
3. Retry the command once the region is reachable; check `nomad server members` for that region

Example fix

// before
// region 'west' not federated -> Error fetching deployments for job example: dial tcp ...: refuse
// after
nomad server members -region=west   # confirm region health, fix federation, retry

opts := &api.QueryOptions{Region: region.Name}
if _, _, err := c.Agent().Regions(); err != nil {
    return fmt.Errorf("region %s not reachable: %w", region.Name, err)
}

deploys, _, err := c.Jobs().Deployments(d.JobID, false, opts)
if err != nil {
    // transient region error: retry with backoff, then surface region name
    return nil, retryOrWrap(err, "region "+region.Name)
}

When it happens

Trigger: The goroutine spawned per multiregion region calls Jobs().Deployments with opts.Region set and the API errors: unreachable remote region (federation), ACL denial, or RPC timeout.

Common situations: A region in job.Multiregion is unhealthy or not federated; ACL token lacks deployment read in that region; intermittent network partition between regions.

Related errors

• failed querying self endpoint: %s
• error retrieving supported Envoy versions from Consul: %w
• Error fetching job: %v
• Failed to retrieve evaluations for job %q: %w
• Nomad Enterprise only endpoint

AI-assisted analysis of hashicorp/nomad@482b49bf1a (2026-09-04). Data as JSON: /api/errors/e298da8d4b7975ab. Report an issue: GitHub.