github.com/uchennaokeke444/nomad@v0.11.8/website/pages/api-docs/system.mdx (about)

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