Files
nomad/website/content/commands/node-pool/jobs.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

80 lines
2.4 KiB
Plaintext

---
layout: docs
page_title: 'nomad node pool jobs command reference'
description: |
The `nomad node pool jobs` command displays jobs in the specified node pool.
---
# `nomad node pool jobs` command reference
The `node pool jobs` command is used to list jobs in a node pool.
## Usage
```plaintext
nomad node pool jobs [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. The results will
be filtered by the namespaces where the token has `read-job` capability.
## Options
- `-filter`: Specifies an expression used to [filter results][api_filtering].
- `-json`: Output the jobs 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 jobs using a Go template.
## Examples
List jobs in a specific namespace in the `prod` node pool:
```shell-session
$ nomad node pool jobs -namespace default prod
ID Type Priority Status Submit Date
job1 service 80 running 07/25/17 15:47:11 UTC
job2 batch 40 complete 07/24/17 19:22:11 UTC
job3 service 50 dead (stopped) 07/22/17 16:34:48 UTC
```
List jobs in all namespaces in the `prod` node pool:
```shell-session
$ nomad node pool jobs -namespace '*' prod
ID Namespace Type Priority Status Submit Date
job1 default service 80 running 07/25/17 15:47:11 UTC
job2 default batch 40 complete 07/24/17 19:22:11 UTC
job3 system service 50 dead (stopped) 07/22/17 16:34:48 UTC
```
Paginate list:
```shell-session
$ nomad node pool jobs -per-page 2 prod
ID Type Priority Status Submit Date
job1 service 80 running 07/25/17 15:47:11 UTC
job2 batch 40 complete 07/24/17 19:22:11 UTC
Results have been paginated. To get the next page run:
nomad node pool jobs -per-page 2 -page-token job3 prod
$ nomad node pool jobs -per-page 2 -page-token job3 prod
ID Type Priority Status Submit Date
job3 service 50 dead (stopped) 07/22/17 16:34:48 UTC
```
## General options
@include 'general_options.mdx'
[api_filtering]: /nomad/api-docs#filtering
[api_pagination]: /nomad/api-docs#pagination