github.com/iqoqo/nomad@v0.11.3-0.20200911112621-d7021c74d101/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-sessioncurl \
    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-sessioncurl \
    56      https://localhost:4646/v1/system/reconcile/summaries
    57  ```