github.com/anth0d/nomad@v0.0.0-20221214183521-ae3a0a2cad06/website/content/docs/commands/operator/root/keyring-remove.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: 'Commands: operator root keyring remove'
     4  description: |
     5    Remove an unused encryption key
     6  ---
     7  
     8  # Command: operator root keyring remove
     9  
    10  The `operator root keyring remove` command removes an encryption key from the
    11  cluster. This operation may only be performed on keys that are not the active
    12  key.
    13  
    14  If ACLs are enabled, this command requires a management token.
    15  
    16  ## Usage
    17  
    18  ```plaintext
    19  nomad operator root keyring remove [options] <key ID>
    20  ```
    21  
    22  ## General Options
    23  
    24  @include 'general_options.mdx'
    25  
    26  ## Examples
    27  
    28  ```shell-session
    29  $ nomad operator root keyring remove 48596ce5-3ff5-8f77-2dcf-301682ada0ce
    30  error: Unexpected response code: 500 (active root key cannot be deleted - call rotate first)
    31  
    32  $ nomad operator root keyring remove 33374156-9f81-b14c-83d4-a2f1f87dbf99
    33  Removed encryption key 33374156-9f81-b14c-83d4-a2f1f87dbf99
    34  ```