github.com/anth0d/nomad@v0.0.0-20221214183521-ae3a0a2cad06/website/content/docs/commands/namespace/list.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: 'Commands: namespace list'
     4  description: |
     5    The namespace list command is used to list namespaces.
     6  ---
     7  
     8  # Command: namespace list
     9  
    10  The `namespace list` command is used list available namespaces.
    11  
    12  ~> Namespaces are open source in Nomad 1.0. Namespaces were Enterprise-only
    13  when introduced in Nomad 0.7.
    14  
    15  ## Usage
    16  
    17  ```plaintext
    18  nomad namespace list [options]
    19  ```
    20  
    21  The `namespace list` command requires no arguments.
    22  
    23  If ACLs are enabled, this command requires a management ACL token to view all
    24  namespaces. A non-management token can be used to list namespaces for which it
    25  has an associated capability.
    26  
    27  ## General Options
    28  
    29  @include 'general_options_no_namespace.mdx'
    30  
    31  ## List Options
    32  
    33  - `-json` : Output the namespaces in their JSON format.
    34  
    35  - `-t` : Format and display the namespaces using a Go template.
    36  
    37  ## Examples
    38  
    39  List all namespaces:
    40  
    41  ```shell-session
    42  $ nomad namespace list
    43  Name      Description
    44  default   Default shared namespace
    45  api-prod  Production instances of backend API servers
    46  api-qa    QA instances of backend API servers
    47  web-prod  Production instances of webservers
    48  web-qa    QA instances of webservers
    49  ```