2017-09-19 14:47:10 +00:00
|
|
|
---
|
2020-02-06 23:45:31 +00:00
|
|
|
layout: docs
|
|
|
|
page_title: 'Commands: namespace list'
|
|
|
|
sidebar_title: list
|
|
|
|
description: |
|
2017-09-19 14:47:10 +00:00
|
|
|
The namespace list command is used to list namespaces.
|
|
|
|
---
|
|
|
|
|
|
|
|
# Command: namespace list
|
|
|
|
|
|
|
|
The `namespace list` command is used list available namespaces.
|
|
|
|
|
2020-10-22 21:59:40 +00:00
|
|
|
~> Namespaces are open source in Nomad 1.0. Namespaces were Enterprise-only
|
|
|
|
when introduced in Nomad 0.7.
|
2017-09-19 14:47:10 +00:00
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
2019-10-22 13:44:00 +00:00
|
|
|
```plaintext
|
2017-09-19 14:47:10 +00:00
|
|
|
nomad namespace list [options]
|
|
|
|
```
|
|
|
|
|
|
|
|
The `namespace list` command requires no arguments.
|
|
|
|
|
|
|
|
## General Options
|
|
|
|
|
2020-02-06 23:45:31 +00:00
|
|
|
@include 'general_options.mdx'
|
2017-09-19 14:47:10 +00:00
|
|
|
|
|
|
|
## List Options
|
|
|
|
|
2019-10-22 13:44:00 +00:00
|
|
|
- `-json` : Output the namespaces in their JSON format.
|
2017-09-19 14:47:10 +00:00
|
|
|
|
2019-10-22 13:44:00 +00:00
|
|
|
- `-t` : Format and display the namespaces using a Go template.
|
2017-09-19 14:47:10 +00:00
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
List all namespaces:
|
|
|
|
|
2020-05-18 20:53:06 +00:00
|
|
|
```shell-session
|
|
|
|
$ nomad namespace list
|
2017-09-19 14:47:10 +00:00
|
|
|
Name Description
|
|
|
|
default Default shared namespace
|
|
|
|
api-prod Production instances of backend API servers
|
|
|
|
api-qa QA instances of backend API servers
|
|
|
|
web-prod Production instances of webservers
|
|
|
|
web-qa QA instances of webservers
|
|
|
|
```
|