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

     1  ---
     2  layout: docs
     3  page_title: 'Commands: volume deregister'
     4  sidebar_title: deregister
     5  description: |
     6    Deregister volumes with CSI plugins.
     7  ---
     8  
     9  # Command: volume deregister
    10  
    11  The `volume deregister` command deregisters external storage volumes with
    12  Nomad's [Container Storage Interface (CSI)][csi] support. The volume
    13  must exist on the remote storage provider before it can be deregistered
    14  and used by a task.
    15  
    16  ## Usage
    17  
    18  ```plaintext
    19  nomad volume deregister [options] [volume]
    20  ```
    21  
    22  The `volume deregister` command requires a single argument, specifying
    23  the ID of volume to be deregistered. Deregistration will fail if the
    24  volume is still in use by an allocation or in the process of being
    25  unpublished.
    26  
    27  When ACLs are enabled, this command requires a token with the
    28  `csi-write-volume` capability for the volume's namespace.
    29  
    30  ## General Options
    31  
    32  @include 'general_options.mdx'
    33  
    34  ## Deregister Options
    35  
    36  - `-force`: Force deregistration of the volume and immediately drop claims for
    37    terminal allocations. Returns an error if the volume has running
    38    allocations. This does not detach the volume from client nodes.
    39  
    40  [csi]: https://github.com/container-storage-interface/spec