fb5091678b
Should provide cut and paste example for most users. Advanced users should be able to correct URLs to something appropriate.
60 lines
1.6 KiB
Markdown
60 lines
1.6 KiB
Markdown
---
|
|
layout: api
|
|
page_title: System - HTTP API
|
|
sidebar_current: api-system
|
|
description: |-
|
|
The /system endpoints are used for system maintenance.
|
|
---
|
|
|
|
# System HTTP API
|
|
|
|
The `/system` endpoints are used to for system maintenance and should not be
|
|
necessary for most users.
|
|
|
|
## Force GC
|
|
|
|
This endpoint initializes a garbage collection of jobs, evaluations, allocations, and
|
|
nodes. This is an asynchronous operation.
|
|
|
|
| Method | Path | Produces |
|
|
| ------ | ---------------------------| -------------------------- |
|
|
| `PUT` | `/v1/system/gc` | `application/json` |
|
|
|
|
The table below shows this endpoint's support for
|
|
[blocking queries](/api/index.html#blocking-queries) and
|
|
[required ACLs](/api/index.html#acls).
|
|
|
|
| Blocking Queries | ACL Required |
|
|
| ---------------- | ------------ |
|
|
| `NO` | `management` |
|
|
|
|
### Sample Request
|
|
|
|
```text
|
|
$ curl \
|
|
--request PUT \
|
|
https://localhost:4646/v1/system/gc
|
|
```
|
|
|
|
## Reconcile Summaries
|
|
|
|
This endpoint reconciles the summaries of all registered jobs.
|
|
|
|
| Method | Path | Produces |
|
|
| ------ | --------------------------------- | -------------------------- |
|
|
| `PUT` | `/v1/system/reconcile/summaries` | `application/json` |
|
|
|
|
The table below shows this endpoint's support for
|
|
[blocking queries](/api/index.html#blocking-queries) and
|
|
[required ACLs](/api/index.html#acls).
|
|
|
|
| Blocking Queries | ACL Required |
|
|
| ---------------- | ------------ |
|
|
| `NO` | `management` |
|
|
### Sample Request
|
|
|
|
```text
|
|
$ curl \
|
|
https://localhost:4646/v1/system/reconcile/summaries
|
|
```
|