github.com/anth0d/nomad@v0.0.0-20221214183521-ae3a0a2cad06/website/content/api-docs/system.mdx (about)

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