All URIs are relative to http://localhost:4646/v1
Method | HTTP request | Description |
---|---|---|
dispatch_job | post /job/{job_id}/dispatch | dispatches a new instance of a parameterized job |
evaluate_job | post /job/{job_id}/evaluate | creates a new evaluation for the given job. This can be used to force run the scheduling logic if necessary |
force_new_periodic_instance | post /job/{job_id}/periodic/force | forces a new instance of the periodic job. A new instance will be created even if it violates the job's prohibit_overlap settings. As such, this should be only used to immediately run a periodic job |
get_job | get /job/{job_id} | reads information about a single job for its specification and status |
get_job_allocations | get /job/{job_id}/allocations | reads information about a single job's allocations |
get_job_deployments | get /job/{job_id}/deployments | lists a single job's deployments |
get_job_evaluations | get /job/{job_id}/evaluations | reads information about a single job's evaluations |
get_job_latest_deployment | get /job/{job_id}/deployment | get a single job's most recent deployment |
get_job_scale_status | get /job/{job_id}/scale | reads scale information about a job |
get_job_summary | get /job/{job_id}/summary | reads summary information about a job |
get_job_versions | get /job/{job_id}/versions | reads information about all versions of a job |
get_jobs | get /jobs | lists all known jobs in the system registered with Nomad |
parse_job_hcl | post /jobs/parse | parse a HCL jobspec and produce the equivalent JSON encoded job |
plan_job | post /job/{job_id}/plan | invokes a dry-run of the scheduler for the job |
register_job | post /jobs | creates (aka "registers") a new job in the system |
revert_job | post /job/{job_id}/revert | reverts the job to an older version |
scale_task_group | post /job/{job_id}/scale | performs a scaling action against a job. Currently, this endpoint supports scaling the count for a task group |
set_job_stability | post /job/{job_id}/stable | sets the job's stability |
stop_job | delete /job/{job_id} | deregisters a job, and stops all allocations part of it |
update_job | post /job/{job_id} | registers a new job or updates an existing job |
validate_job | post /validate/job | validate object structs, fields, and types |
crate::models::JobDispatchResponse dispatch_job(job_id, namespace, region, index, wait, job_dispatch_request) dispatches a new instance of a parameterized job
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
job_dispatch_request | Option<JobDispatchRequest> |
crate::models::JobDispatchResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::JobRegisterResponse evaluate_job(job_id, namespace, region, index, wait, job_evaluate_request) creates a new evaluation for the given job. This can be used to force run the scheduling logic if necessary
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
job_evaluate_request | Option<JobEvaluateRequest> |
crate::models::JobRegisterResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::PeriodicForceResponse force_new_periodic_instance(job_id, namespace, region, index, wait) forces a new instance of the periodic job. A new instance will be created even if it violates the job's prohibit_overlap settings. As such, this should be only used to immediately run a periodic job
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests |
crate::models::PeriodicForceResponse
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::Job get_job(job_id, namespace, region, index, wait) reads information about a single job for its specification and status
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests |
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Veccrate::models::AllocationListStub get_job_allocations(job_id, namespace, region, index, wait, all) reads information about a single job's allocations
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
all | Option<bool> | Specifies whether should include * from a previously registered job with the same ID. This is possible if the job is deregistered and reregistered. |
Veccrate::models::AllocationListStub
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Veccrate::models::Deployment get_job_deployments(job_id, namespace, region, index, wait, all) lists a single job's deployments
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
all | Option<bool> | Specifies whether should include * from a previously registered job with the same ID. This is possible if the job is deregistered and reregistered. |
Veccrate::models::Deployment
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Veccrate::models::Evaluation get_job_evaluations(job_id, namespace, region, index, wait) reads information about a single job's evaluations
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests |
Veccrate::models::Evaluation
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::Deployment get_job_latest_deployment(job_id, namespace, region, index, wait) get a single job's most recent deployment
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests |
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::JobScaleStatusResponse get_job_scale_status(job_id, namespace, region, index, wait) reads scale information about a job
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests |
crate::models::JobScaleStatusResponse
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::JobSummary get_job_summary(job_id, namespace, region, index, wait) reads summary information about a job
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests |
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::JobVersionsResponse get_job_versions(job_id, namespace, region, index, wait) reads information about all versions of a job
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests |
crate::models::JobVersionsResponse
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Veccrate::models::JobListStub get_jobs(namespace, region, index, wait, prefix) lists all known jobs in the system registered with Nomad
Name | Type | Description | Required | Notes |
---|---|---|---|---|
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
prefix | Option<String> | Specifies a string to filter jobs on based on an index prefix. This is specified as a query string parameter |
Veccrate::models::JobListStub
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::Job parse_job_hcl(namespace, region, index, wait, jobs_parse_request) parse a HCL jobspec and produce the equivalent JSON encoded job
Name | Type | Description | Required | Notes |
---|---|---|---|---|
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
jobs_parse_request | Option<JobsParseRequest> |
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::JobPlanResponse plan_job(job_id, namespace, region, index, wait, job_plan_request) invokes a dry-run of the scheduler for the job
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
job_plan_request | Option<JobPlanRequest> |
crate::models::JobPlanResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::JobRegisterResponse register_job(namespace, region, index, wait, register_job_request) creates (aka "registers") a new job in the system
Name | Type | Description | Required | Notes |
---|---|---|---|---|
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
register_job_request | Option<RegisterJobRequest> |
crate::models::JobRegisterResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::JobRegisterResponse revert_job(job_id, namespace, region, index, wait, job_revert_request) reverts the job to an older version
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
job_revert_request | Option<JobRevertRequest> |
crate::models::JobRegisterResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::JobRegisterResponse scale_task_group(job_id, namespace, region, index, wait, scaling_request) performs a scaling action against a job. Currently, this endpoint supports scaling the count for a task group
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
scaling_request | Option<ScalingRequest> |
crate::models::JobRegisterResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::JobStabilityResponse set_job_stability(job_id, namespace, region, index, wait, job_stability_request) sets the job's stability
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
job_stability_request | Option<JobStabilityRequest> |
crate::models::JobStabilityResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::JobDeregisterResponse stop_job(job_id, namespace, region, index, wait, purge) deregisters a job, and stops all allocations part of it
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
purge | Option<bool> | Specifies that the job should stopped and purged immediately. This means the job will not be queryable after being stopped. If not set, the job will be purged by the garbage collector |
crate::models::JobDeregisterResponse
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::JobRegisterResponse update_job(job_id, namespace, region, index, wait, register_job_request) registers a new job or updates an existing job
Name | Type | Description | Required | Notes |
---|---|---|---|---|
job_id | String | job id | [required] | |
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
register_job_request | Option<RegisterJobRequest> |
crate::models::JobRegisterResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::JobValidateResponse validate_job(namespace, region, index, wait, job_validate_request) validate object structs, fields, and types
Name | Type | Description | Required | Notes |
---|---|---|---|---|
namespace | Option<String> | |||
region | Option<String> | Make a request across regions to the given region | ||
index | Option<i64> | index used for blocking requests | ||
wait | Option<String> | wait time used for blocking requests | ||
job_validate_request | Option<JobValidateRequest> |
crate::models::JobValidateResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]