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

     1  ---
     2  layout: docs
     3  page_title: 'Commands: service list'
     4  description: |
     5    The service list command is used to list the registered Nomad services.
     6  ---
     7  
     8  # Command: service list
     9  
    10  The `service list` command is used to list the registered Nomad services.
    11  
    12  ~> Service commands are new in Nomad 1.3.
    13  
    14  ## Usage
    15  
    16  ```plaintext
    17  nomad service list [options]
    18  ```
    19  
    20  The `service list` command requires no arguments.
    21  
    22  When ACLs are enabled, this command requires a token with the `read-job`
    23  capability for the namespace being queried.
    24  
    25  The command supports the wildcard namespace identifier. Any namespaces that
    26  the token does not have access to will have its services filtered from the
    27  results.
    28  
    29  ## General Options
    30  
    31  @include 'general_options.mdx'
    32  
    33  ## List Options
    34  
    35  - `-json`: Output the services in its JSON format.
    36  
    37  - `-t`: Format and display the services using a Go template.
    38  
    39  ## Examples
    40  
    41  List all services in the `default` namespace:
    42  
    43  ```shell-session
    44  $ nomad service list
    45  Service Name         Tags
    46  example-cache-redis  [cache,db]
    47  ```
    48  
    49  List all services in all namespaces:
    50  
    51  ```shell-session
    52  $ nomad service list -namespace="*"
    53  Service Name                  Namespace  Tags
    54  example-cache-redis           default    [cache,db]
    55  platform-example-cache-redis  platform   []
    56  ```