Administration API
Administration API documentation for Java SDK
All URIs are relative to *http://localhost:8080*
| Method | HTTP request | Description |
|---|---|---|
| drainServer | POST /v1/admin:drain | Request the server to enter drain mode |
| purgeBackgroundJobs | POST /v1/admin/background-jobs:purge | Purge completed background jobs |
| reloadLicense | POST /v1/admin/license:reload | Reload the active license from disk |
drainServer
AdminDrainResponse drainServer(adminDrainRequest)
Request the server to enter drain mode
Initiates drain mode and optionally waits for the server to quiesce.
Example
// Import classes:
import ai.pairsys.goodmem.client.ApiClient;
import ai.pairsys.goodmem.client.ApiException;
import ai.pairsys.goodmem.client.Configuration;
import ai.pairsys.goodmem.client.auth.*;
import ai.pairsys.goodmem.client.models.*;
import ai.pairsys.goodmem.client.api.AdministrationApi;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = Configuration.getDefaultApiClient();
defaultClient.setBasePath("[http://localhost:8080](http://localhost:8080)");
// Configure API key authorization: ApiKeyAuth
ApiKeyAuth ApiKeyAuth = (ApiKeyAuth) defaultClient.getAuthentication("ApiKeyAuth");
ApiKeyAuth.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//ApiKeyAuth.setApiKeyPrefix("Token");
AdministrationApi apiInstance = new AdministrationApi(defaultClient);
AdminDrainRequest adminDrainRequest = new AdminDrainRequest(); // AdminDrainRequest |
try {
AdminDrainResponse result = apiInstance.drainServer(adminDrainRequest);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling AdministrationApi#drainServer");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| adminDrainRequest | AdminDrainRequest | [optional] |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Drain request acknowledged | - |
| 401 | Unauthorized - invalid or missing API key | - |
| 403 | Forbidden - missing permissions | - |
purgeBackgroundJobs
AdminPurgeJobsResponse purgeBackgroundJobs(adminPurgeJobsRequest)
Purge completed background jobs
Deletes terminal background jobs older than a retention cutoff.
Example
// Import classes:
import ai.pairsys.goodmem.client.ApiClient;
import ai.pairsys.goodmem.client.ApiException;
import ai.pairsys.goodmem.client.Configuration;
import ai.pairsys.goodmem.client.auth.*;
import ai.pairsys.goodmem.client.models.*;
import ai.pairsys.goodmem.client.api.AdministrationApi;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = Configuration.getDefaultApiClient();
defaultClient.setBasePath("[http://localhost:8080](http://localhost:8080)");
// Configure API key authorization: ApiKeyAuth
ApiKeyAuth ApiKeyAuth = (ApiKeyAuth) defaultClient.getAuthentication("ApiKeyAuth");
ApiKeyAuth.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//ApiKeyAuth.setApiKeyPrefix("Token");
AdministrationApi apiInstance = new AdministrationApi(defaultClient);
AdminPurgeJobsRequest adminPurgeJobsRequest = new AdminPurgeJobsRequest(); // AdminPurgeJobsRequest |
try {
AdminPurgeJobsResponse result = apiInstance.purgeBackgroundJobs(adminPurgeJobsRequest);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling AdministrationApi#purgeBackgroundJobs");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| adminPurgeJobsRequest | AdminPurgeJobsRequest | [optional] |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Purge completed | - |
| 400 | Invalid request payload | - |
| 401 | Unauthorized - invalid or missing API key | - |
| 403 | Forbidden - missing permissions | - |
reloadLicense
AdminReloadLicenseResponse reloadLicense()
Reload the active license from disk
Triggers the server to reload its license file from the configured directory and returns metadata about the currently active license.
Example
// Import classes:
import ai.pairsys.goodmem.client.ApiClient;
import ai.pairsys.goodmem.client.ApiException;
import ai.pairsys.goodmem.client.Configuration;
import ai.pairsys.goodmem.client.auth.*;
import ai.pairsys.goodmem.client.models.*;
import ai.pairsys.goodmem.client.api.AdministrationApi;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = Configuration.getDefaultApiClient();
defaultClient.setBasePath("[http://localhost:8080](http://localhost:8080)");
// Configure API key authorization: ApiKeyAuth
ApiKeyAuth ApiKeyAuth = (ApiKeyAuth) defaultClient.getAuthentication("ApiKeyAuth");
ApiKeyAuth.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//ApiKeyAuth.setApiKeyPrefix("Token");
AdministrationApi apiInstance = new AdministrationApi(defaultClient);
try {
AdminReloadLicenseResponse result = apiInstance.reloadLicense();
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling AdministrationApi#reloadLicense");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}Parameters
This endpoint does not need any parameter.
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | License reload attempt processed | - |
| 401 | Unauthorized - invalid or missing API key | - |
| 403 | Forbidden - missing permissions | - |