Files
2025-09-26 07:44:58 +01:00

74 lines
1.5 KiB
Plaintext

---
layout: docs
page_title: 'nomad node pool info command reference'
description: |
The `nomad node pool info` command displays information about a node pool.
---
# `nomad node pool info` command reference
The `node pool info` command is used to fetch information about an existing
node pool.
## Usage
```plaintext
nomad node pool info [options] <node-pool>
```
If ACLs are enabled, this command requires a token with the `read` capability
in a `node_pool` policy that matches the node pool being targeted.
## Options
- `-json`: Output the node pool in its JSON format.
- `-t`: Format and display node pool using a Go template.
## Examples
Retrieve information on a node pool:
```shell-session
$ nomad node pool info prod
Name = prod
Description = Node pool for production workloads.
Node Identity TTL = "24h0m0s"
Metadata
env = production
Scheduler Configuration
Scheduler Algorithm = spread
```
Retrieve information in JSON format:
```shell-session
$ nomad node pool info -json prod
{
"CreateIndex": 39,
"Description": "Node pool for production workloads.",
"Meta": {
"env": "production"
},
"ModifyIndex": 39,
"Name": "prod",
"NodeIdentityTTL": "24h0m0s",
"SchedulerConfiguration": {
"SchedulerAlgorithm": "spread"
}
}
```
Customize output with a Go template:
```shell-session
$ nomad node pool info -t "{{.Name}} [{{.Meta.env}}] - {{.Description}}" prod
prod [production] - Node pool for production workloads.
```
## General options
@include 'general_options_no_namespace.mdx'