github.com/smintz/nomad@v0.8.3/website/source/api/system.html.md (about)

     1  ---
     2  layout: api
     3  page_title: System - HTTP API
     4  sidebar_current: api-system
     5  description: |-
     6    The /system endpoints are used for system maintenance.
     7  ---
     8  
     9  # System HTTP API
    10  
    11  The `/system` endpoints are used to for system maintenance and should not be
    12  necessary for most users.
    13  
    14  ## Force GC
    15  
    16  This endpoint initializes a garbage collection of jobs, evaluations, allocations, and
    17  nodes. This is an asynchronous operation.
    18  
    19  | Method | Path                       | Produces                   |
    20  | ------ | ---------------------------| -------------------------- |
    21  | `PUT`  | `/v1/system/gc`            | `application/json`         |
    22  
    23  The table below shows this endpoint's support for
    24  [blocking queries](/api/index.html#blocking-queries) and
    25  [required ACLs](/api/index.html#acls).
    26  
    27  | Blocking Queries | ACL Required |
    28  | ---------------- | ------------ |
    29  | `NO`             | `management` |
    30  
    31  ### Sample Request
    32  
    33  ```text
    34  $ curl \
    35      --request PUT \
    36      https://localhost:4646/v1/system/gc
    37  ```
    38  
    39  ## Reconcile Summaries
    40  
    41  This endpoint reconciles the summaries of all registered jobs.
    42  
    43  | Method | Path                              | Produces                   |
    44  | ------ | --------------------------------- | -------------------------- |
    45  | `PUT`  | `/v1/system/reconcile/summaries`  | `application/json`         |
    46  
    47  The table below shows this endpoint's support for
    48  [blocking queries](/api/index.html#blocking-queries) and
    49  [required ACLs](/api/index.html#acls).
    50  
    51  | Blocking Queries | ACL Required |
    52  | ---------------- | ------------ |
    53  | `NO`             | `management` |
    54  ### Sample Request
    55  
    56  ```text
    57  $ curl \
    58      https://localhost:4646/v1/system/reconcile/summaries
    59  ```