2017-10-13 23:26:39 +00:00
|
|
|
---
|
2020-02-06 23:45:31 +00:00
|
|
|
layout: docs
|
|
|
|
page_title: 'Commands: namespace status'
|
2017-10-13 23:26:39 +00:00
|
|
|
description: >
|
|
|
|
The namespace status command is used to view the status of a particular
|
|
|
|
namespace.
|
|
|
|
---
|
|
|
|
|
|
|
|
# Command: namespace status
|
|
|
|
|
|
|
|
The `namespace status` command is used to view the status of a particular
|
|
|
|
namespace.
|
|
|
|
|
2020-10-22 21:59:40 +00:00
|
|
|
~> Namespaces are open source in Nomad 1.0. Namespaces were Enterprise-only
|
2020-12-07 22:04:11 +00:00
|
|
|
when introduced in Nomad 0.7.
|
2018-03-22 20:39:18 +00:00
|
|
|
|
2017-10-13 23:26:39 +00:00
|
|
|
## Usage
|
|
|
|
|
2019-10-22 13:44:00 +00:00
|
|
|
```plaintext
|
2017-10-13 23:26:39 +00:00
|
|
|
nomad namespace status [options] <namespace_name>
|
|
|
|
```
|
|
|
|
|
2020-11-19 21:38:08 +00:00
|
|
|
If ACLs are enabled, this command requires a management ACL token or a token
|
|
|
|
that has a capability associated with the namespace.
|
|
|
|
|
2017-10-13 23:26:39 +00:00
|
|
|
## General Options
|
|
|
|
|
2020-11-19 18:02:48 +00:00
|
|
|
@include 'general_options_no_namespace.mdx'
|
2017-10-13 23:26:39 +00:00
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
View the status of a namespace:
|
|
|
|
|
2020-05-18 20:53:06 +00:00
|
|
|
```shell-session
|
|
|
|
$ nomad namespace status default
|
2022-03-04 22:18:57 +00:00
|
|
|
Name = api-prod
|
|
|
|
Description = Prod API servers
|
|
|
|
Quota = prod
|
2022-02-24 14:27:32 +00:00
|
|
|
EnabledDrivers = docker,exec
|
|
|
|
DisabledDrivers = raw_exec
|
2022-03-04 22:18:57 +00:00
|
|
|
|
|
|
|
Metadata
|
|
|
|
contact = platform-eng@example.com
|
2017-10-13 23:26:39 +00:00
|
|
|
|
|
|
|
Quota Limits
|
|
|
|
Region CPU Usage Memory Usage
|
|
|
|
global 500 / 2500 256 / 2000
|
|
|
|
```
|