Files
nomad/website/content/commands/node-pool/nodes.mdx
Aimee Ukasick 53b083b8c5 Docs: Nomad IA (#26063)
* Move commands from docs to its own root-level directory

* temporarily use modified dev-portal branch with nomad ia changes

* explicitly clone nomad ia exp branch

* retrigger build, fixed dev-portal broken build

* architecture, concepts and get started individual pages

* fix get started section destinations

* reference section

* update repo comment in website-build.sh to show branch

* docs nav file update capitalization

* update capitalization to force deploy

* remove nomad-vs-kubernetes dir; move content to what is nomad pg

* job section

* Nomad operations category, deploy section

* operations category, govern section

* operations - manage

* operations/scale; concepts scheduling fix

* networking

* monitor

* secure section

* remote auth-methods folder and move up pages to sso; linkcheck

* Fix install2deploy redirects

* fix architecture redirects

* Job section: Add missing section index pages

* Add section index pages so breadcrumbs build correctly

* concepts/index fix front matter indentation

* move task driver plugin config to new deploy section

* Finish adding full URL to tutorials links in nav

* change SSO to Authentication in nav and file system

* Docs NomadIA: Move tutorials into NomadIA branch (#26132)

* Move governance and policy from tutorials to docs

* Move tutorials content to job-declare section

* run jobs section

* stateful workloads

* advanced job scheduling

* deploy section

* manage section

* monitor section

* secure/acl and secure/authorization

* fix example that contains an unseal key in real format

* remove images from sso-vault

* secure/traffic

* secure/workload-identities

* vault-acl change unseal key and root token in command output sample

* remove lines from sample output

* fix front matter

* move nomad pack tutorials to tools

* search/replace /nomad/tutorials links

* update acl overview with content from deleted architecture/acl

* fix spelling mistake

* linkcheck - fix broken links

* fix link to Nomad variables tutorial

* fix link to Prometheus tutorial

* move who uses Nomad to use cases page; move spec/config shortcuts

add dividers

* Move Consul out of Integrations; move namespaces to govern

* move integrations/vault to secure/vault; delete integrations

* move ref arch to docs; rename Deploy Nomad back to Install Nomad

* address feedback

* linkcheck fixes

* Fixed raw_exec redirect

* add info from /nomad/tutorials/manage-jobs/jobs

* update page content with newer tutorial

* link updates for architecture sub-folders

* Add redirects for removed section index pages. Fix links.

* fix broken links from linkcheck

* Revert to use dev-portal main branch instead of nomadIA branch

* build workaround: add intro-nav-data.json with single entry

* fix content-check error

* add intro directory to get around Vercel build error

* workound for emtpry directory

* remove mdx from /intro/ to fix content-check and git snafu

* Add intro index.mdx so Vercel build should work

---------

Co-authored-by: Tu Nguyen <im2nguyen@gmail.com>
2025-07-08 19:24:52 -05:00

77 lines
2.1 KiB
Plaintext

---
layout: docs
page_title: 'nomad node pool nodes command reference'
description: |
The `nomad node pool nodes` command displays nodes in the specified node pool.
---
# `nomad node pool nodes` command reference
The `node pool nodes` command is used to list nodes in a node pool.
## Usage
```plaintext
nomad node pool nodes [options] <node-pool>
```
If ACLs are enabled, this command requires a token with the `node:read`
capability and the `read` capability in a `node_pool` policy that matches the
node pool being targeted.
## Options
- `-filter`: Specifies an expression used to [filter results][api_filtering].
- `-json`: Output the nodes in JSON format.
- `-page-token`: Where to start [pagination][api_pagination].
- `-per-page`: How many results to show per page. If not specified, or set to
`0`, all results are returned.
- `-t`: Format and display nodes using a Go template.
- `-verbose`: Display full information.
## Examples
List nodes in the `prod` node pool:
```shell-session
$ nomad node pool nodes prod
ID DC Name Class Drain Eligibility Status
31c5347f dc2 client-3 <none> false eligible ready
3ed547cd dc1 client-1 <none> false eligible ready
6e98e378 dc2 client-2 <none> false eligible ready
```
Filter nodes with an expression:
```shell-session
$ nomad node pool nodes -filter='Datacenter == "dc2"' prod
ID DC Name Class Drain Eligibility Status
31c5347f dc2 client-3 <none> false eligible ready
6e98e378 dc2 client-2 <none> false eligible ready
```
Paginate list:
```shell-session
$ nomad node pool nodes -per-page=2 prod
ID DC Name Class Drain Eligibility Status
31c5347f dc2 us-client-3 <none> false eligible ready
3ed547cd dc1 us-client-1 <none> false eligible ready
Results have been paginated. To get the next page run:
nomad node pool nodes -per-page=2 prod -page-token 6e98e378-b41a-86ac-8e5e-5ca8ab66236d
```
## General options
@include 'general_options_no_namespace.mdx'
[api_filtering]: /nomad/api-docs#filtering
[api_pagination]: /nomad/api-docs#pagination