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

     1  ---
     2  layout: docs
     3  page_title: 'Commands: namespace apply'
     4  sidebar_title: apply
     5  description: |
     6    The namespace apply command is used create or update a namespace.
     7  ---
     8  
     9  # Command: namespace apply
    10  
    11  The `namespace apply` command is used create or update a namespace.
    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 apply [options] <namespace>
    20  ```
    21  
    22  The `namespace apply` command requires the name of the namespace to be created
    23  or updated.
    24  
    25  If ACLs are enabled, this command requires a management ACL token.
    26  
    27  ## General Options
    28  
    29  @include 'general_options_no_namespace.mdx'
    30  
    31  ## Apply Options
    32  
    33  - `-quota` : An optional quota to apply to the namespace.
    34  
    35  - `-description` : An optional human readable description for the namespace.
    36  
    37  ## Examples
    38  
    39  Create a namespace with a quota:
    40  
    41  ```shell-session
    42  $ nomad namespace apply -description "Prod API servers" -quota prod api-prod
    43  Successfully applied namespace "api-prod"!
    44  ```
    45  
    46  Remove a quota from a namespace:
    47  
    48  ```shell-session
    49  $ nomad namespace apply -quota= api-prod
    50  ```