Files
nomad/website/content/docs/commands/deployment/pause.mdx
Aimee Ukasick 23fd87d9c9 Docs: Commands section move "General options" to page bottom (#26001)
* sectionless files plus acl section

* alloc section

* config, deployment sections

* job section

* licence, namespace

* node, node-pool

* operator

* plugin, quota, recommendation

* scaling, sentinel, server, service, system, var, volume

* Add "ENT" label to left nav for enterprise commands

* job tag break into separate folder and files; update options header
2025-06-12 14:31:38 -05:00

42 lines
949 B
Plaintext

---
layout: docs
page_title: 'nomad deployment pause command reference'
description: >
The `nomad deployment pause` command pauses a deployment and does not allow new allocations.
---
# `nomad deployment pause` command reference
The `deployment pause` command is used to pause a deployment. Pausing a
deployment will pause the placement of new allocations as part of rolling
deployment.
## Usage
```plaintext
nomad deployment pause [options] <deployment id>
```
The `deployment pause` command requires a single argument, a deployment ID or
prefix.
When ACLs are enabled, this command requires a token with the `submit-job`
and `read-job` capabilities for the deployment's namespace.
## Options
- `-verbose`: Show full information.
## Examples
Manually pause a deployment:
```shell-session
$ nomad deployment pause 2f14ba55
Deployment "2f14ba55-acfb-cb31-821c-facf1b9b0830" paused
```
## General options
@include 'general_options.mdx'