github.com/Ilhicas/nomad@v1.0.4-0.20210304152020-e86851182bc3/website/content/docs/commands/namespace/list.mdx (about)

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