Nomad v2.3.0 published on Wednesday, Jun 5, 2024 by Pulumi
nomad.getJob
Explore with Pulumi AI
Get information on a job ID. The aim of this datasource is to enable you to act on various settings and states of a particular job.
An error is triggered if zero or more than one result is returned by the query.
Example Usage
Get the data about a snapshot:
import * as pulumi from "@pulumi/pulumi";
import * as nomad from "@pulumi/nomad";
const example = nomad.getJob({
    jobId: "example",
    namespace: "dev",
});
import pulumi
import pulumi_nomad as nomad
example = nomad.get_job(job_id="example",
    namespace="dev")
package main
import (
	"github.com/pulumi/pulumi-nomad/sdk/v2/go/nomad"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := nomad.LookupJob(ctx, &nomad.LookupJobArgs{
			JobId:     "example",
			Namespace: pulumi.StringRef("dev"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Nomad = Pulumi.Nomad;
return await Deployment.RunAsync(() => 
{
    var example = Nomad.GetJob.Invoke(new()
    {
        JobId = "example",
        Namespace = "dev",
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.nomad.NomadFunctions;
import com.pulumi.nomad.inputs.GetJobArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var example = NomadFunctions.getJob(GetJobArgs.builder()
            .jobId("example")
            .namespace("dev")
            .build());
    }
}
variables:
  example:
    fn::invoke:
      Function: nomad:getJob
      Arguments:
        jobId: example
        namespace: dev
Using getJob
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getJob(args: GetJobArgs, opts?: InvokeOptions): Promise<GetJobResult>
function getJobOutput(args: GetJobOutputArgs, opts?: InvokeOptions): Output<GetJobResult>def get_job(job_id: Optional[str] = None,
            namespace: Optional[str] = None,
            opts: Optional[InvokeOptions] = None) -> GetJobResult
def get_job_output(job_id: Optional[pulumi.Input[str]] = None,
            namespace: Optional[pulumi.Input[str]] = None,
            opts: Optional[InvokeOptions] = None) -> Output[GetJobResult]func LookupJob(ctx *Context, args *LookupJobArgs, opts ...InvokeOption) (*LookupJobResult, error)
func LookupJobOutput(ctx *Context, args *LookupJobOutputArgs, opts ...InvokeOption) LookupJobResultOutput> Note: This function is named LookupJob in the Go SDK.
public static class GetJob 
{
    public static Task<GetJobResult> InvokeAsync(GetJobArgs args, InvokeOptions? opts = null)
    public static Output<GetJobResult> Invoke(GetJobInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetJobResult> getJob(GetJobArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: nomad:index/getJob:getJob
  arguments:
    # arguments dictionaryThe following arguments are supported:
getJob Result
The following output properties are available:
- All
At boolOnce  (boolean)If the scheduler can make partial placements on oversubscribed nodes.- Constraints
List<Get
Job Constraint>  - Create
Index int (integer)Creation Index.- Datacenters List<string>
 (list of strings)Datacenters allowed to run the specified job.- Id string
 - The provider-assigned unique ID for this managed resource.
 - Job
Id string - Job
Modify intIndex  (integer)Job modify index (used for version verification).- Modify
Index int (integer)Modification Index.- Name string
 (string)Name of the job.- Parent
Id string (string)Job's parent ID.- Periodic
Configs List<GetJob Periodic Config>  (list of maps)Job's periodic configuration (time based scheduling).- Priority int
 (integer)Used for the prioritization of scheduling and resource access.- Region string
 (string)Region where the Nomad cluster resides.- Stable bool
 (boolean)Job stability status.- Status string
 (string)Execution status of the specified job.- Status
Description string (string)Status description of the specified job.- Stop bool
 (boolean)Job enabled status.- Submit
Time int (integer)Job submission date.- Task
Groups List<GetJob Task Group>  (list of maps)A list of of the job's task groups.- Type string
 (string)Scheduler type used during job creation.- Version int
 (integer)Version of the specified job.- Namespace string
 
- All
At boolOnce  (boolean)If the scheduler can make partial placements on oversubscribed nodes.- Constraints
[]Get
Job Constraint  - Create
Index int (integer)Creation Index.- Datacenters []string
 (list of strings)Datacenters allowed to run the specified job.- Id string
 - The provider-assigned unique ID for this managed resource.
 - Job
Id string - Job
Modify intIndex  (integer)Job modify index (used for version verification).- Modify
Index int (integer)Modification Index.- Name string
 (string)Name of the job.- Parent
Id string (string)Job's parent ID.- Periodic
Configs []GetJob Periodic Config  (list of maps)Job's periodic configuration (time based scheduling).- Priority int
 (integer)Used for the prioritization of scheduling and resource access.- Region string
 (string)Region where the Nomad cluster resides.- Stable bool
 (boolean)Job stability status.- Status string
 (string)Execution status of the specified job.- Status
Description string (string)Status description of the specified job.- Stop bool
 (boolean)Job enabled status.- Submit
Time int (integer)Job submission date.- Task
Groups []GetJob Task Group  (list of maps)A list of of the job's task groups.- Type string
 (string)Scheduler type used during job creation.- Version int
 (integer)Version of the specified job.- Namespace string
 
- all
At BooleanOnce  (boolean)If the scheduler can make partial placements on oversubscribed nodes.- constraints
List<Get
Job Constraint>  - create
Index Integer (integer)Creation Index.- datacenters List<String>
 (list of strings)Datacenters allowed to run the specified job.- id String
 - The provider-assigned unique ID for this managed resource.
 - job
Id String - job
Modify IntegerIndex  (integer)Job modify index (used for version verification).- modify
Index Integer (integer)Modification Index.- name String
 (string)Name of the job.- parent
Id String (string)Job's parent ID.- periodic
Configs List<GetJob Periodic Config>  (list of maps)Job's periodic configuration (time based scheduling).- priority Integer
 (integer)Used for the prioritization of scheduling and resource access.- region String
 (string)Region where the Nomad cluster resides.- stable Boolean
 (boolean)Job stability status.- status String
 (string)Execution status of the specified job.- status
Description String (string)Status description of the specified job.- stop Boolean
 (boolean)Job enabled status.- submit
Time Integer (integer)Job submission date.- task
Groups List<GetJob Task Group>  (list of maps)A list of of the job's task groups.- type String
 (string)Scheduler type used during job creation.- version Integer
 (integer)Version of the specified job.- namespace String
 
- all
At booleanOnce  (boolean)If the scheduler can make partial placements on oversubscribed nodes.- constraints
Get
Job Constraint[]  - create
Index number (integer)Creation Index.- datacenters string[]
 (list of strings)Datacenters allowed to run the specified job.- id string
 - The provider-assigned unique ID for this managed resource.
 - job
Id string - job
Modify numberIndex  (integer)Job modify index (used for version verification).- modify
Index number (integer)Modification Index.- name string
 (string)Name of the job.- parent
Id string (string)Job's parent ID.- periodic
Configs GetJob Periodic Config[]  (list of maps)Job's periodic configuration (time based scheduling).- priority number
 (integer)Used for the prioritization of scheduling and resource access.- region string
 (string)Region where the Nomad cluster resides.- stable boolean
 (boolean)Job stability status.- status string
 (string)Execution status of the specified job.- status
Description string (string)Status description of the specified job.- stop boolean
 (boolean)Job enabled status.- submit
Time number (integer)Job submission date.- task
Groups GetJob Task Group[]  (list of maps)A list of of the job's task groups.- type string
 (string)Scheduler type used during job creation.- version number
 (integer)Version of the specified job.- namespace string
 
- all_
at_ boolonce  (boolean)If the scheduler can make partial placements on oversubscribed nodes.- constraints
Sequence[Get
Job Constraint]  - create_
index int (integer)Creation Index.- datacenters Sequence[str]
 (list of strings)Datacenters allowed to run the specified job.- id str
 - The provider-assigned unique ID for this managed resource.
 - job_
id str - job_
modify_ intindex  (integer)Job modify index (used for version verification).- modify_
index int (integer)Modification Index.- name str
 (string)Name of the job.- parent_
id str (string)Job's parent ID.- periodic_
configs Sequence[GetJob Periodic Config]  (list of maps)Job's periodic configuration (time based scheduling).- priority int
 (integer)Used for the prioritization of scheduling and resource access.- region str
 (string)Region where the Nomad cluster resides.- stable bool
 (boolean)Job stability status.- status str
 (string)Execution status of the specified job.- status_
description str (string)Status description of the specified job.- stop bool
 (boolean)Job enabled status.- submit_
time int (integer)Job submission date.- task_
groups Sequence[GetJob Task Group]  (list of maps)A list of of the job's task groups.- type str
 (string)Scheduler type used during job creation.- version int
 (integer)Version of the specified job.- namespace str
 
- all
At BooleanOnce  (boolean)If the scheduler can make partial placements on oversubscribed nodes.- constraints List<Property Map>
 - create
Index Number (integer)Creation Index.- datacenters List<String>
 (list of strings)Datacenters allowed to run the specified job.- id String
 - The provider-assigned unique ID for this managed resource.
 - job
Id String - job
Modify NumberIndex  (integer)Job modify index (used for version verification).- modify
Index Number (integer)Modification Index.- name String
 (string)Name of the job.- parent
Id String (string)Job's parent ID.- periodic
Configs List<Property Map> (list of maps)Job's periodic configuration (time based scheduling).- priority Number
 (integer)Used for the prioritization of scheduling and resource access.- region String
 (string)Region where the Nomad cluster resides.- stable Boolean
 (boolean)Job stability status.- status String
 (string)Execution status of the specified job.- status
Description String (string)Status description of the specified job.- stop Boolean
 (boolean)Job enabled status.- submit
Time Number (integer)Job submission date.- task
Groups List<Property Map> (list of maps)A list of of the job's task groups.- type String
 (string)Scheduler type used during job creation.- version Number
 (integer)Version of the specified job.- namespace String
 
Supporting Types
GetJobConstraint  
GetJobPeriodicConfig   
- Enabled bool
 (boolean)If periodic scheduling is enabled for the specified job.- Prohibit
Overlap bool (boolean)If the specified job should wait until previous instances of the job have completed.- Spec string
 (string)- Spec
Type string (string)- Timezone string
 (string)Time zone to evaluate the next launch interval against.
- Enabled bool
 (boolean)If periodic scheduling is enabled for the specified job.- Prohibit
Overlap bool (boolean)If the specified job should wait until previous instances of the job have completed.- Spec string
 (string)- Spec
Type string (string)- Timezone string
 (string)Time zone to evaluate the next launch interval against.
- enabled Boolean
 (boolean)If periodic scheduling is enabled for the specified job.- prohibit
Overlap Boolean (boolean)If the specified job should wait until previous instances of the job have completed.- spec String
 (string)- spec
Type String (string)- timezone String
 (string)Time zone to evaluate the next launch interval against.
- enabled boolean
 (boolean)If periodic scheduling is enabled for the specified job.- prohibit
Overlap boolean (boolean)If the specified job should wait until previous instances of the job have completed.- spec string
 (string)- spec
Type string (string)- timezone string
 (string)Time zone to evaluate the next launch interval against.
- enabled bool
 (boolean)If periodic scheduling is enabled for the specified job.- prohibit_
overlap bool (boolean)If the specified job should wait until previous instances of the job have completed.- spec str
 (string)- spec_
type str (string)- timezone str
 (string)Time zone to evaluate the next launch interval against.
- enabled Boolean
 (boolean)If periodic scheduling is enabled for the specified job.- prohibit
Overlap Boolean (boolean)If the specified job should wait until previous instances of the job have completed.- spec String
 (string)- spec
Type String (string)- timezone String
 (string)Time zone to evaluate the next launch interval against.
GetJobTaskGroup   
- Count int
 - Meta Dictionary<string, object>
 - Name string
 (string)Name of the job.- Tasks
List<Get
Job Task Group Task>  - Volumes
List<Get
Job Task Group Volume>  
- Count int
 - Meta map[string]interface{}
 - Name string
 (string)Name of the job.- Tasks
[]Get
Job Task Group Task  - Volumes
[]Get
Job Task Group Volume  
- count Integer
 - meta Map<String,Object>
 - name String
 (string)Name of the job.- tasks
List<Get
Job Task Group Task>  - volumes
List<Get
Job Task Group Volume>  
- count number
 - meta {[key: string]: any}
 - name string
 (string)Name of the job.- tasks
Get
Job Task Group Task[]  - volumes
Get
Job Task Group Volume[]  
- count int
 - meta Mapping[str, Any]
 - name str
 (string)Name of the job.- tasks
Sequence[Get
Job Task Group Task]  - volumes
Sequence[Get
Job Task Group Volume]  
- count Number
 - meta Map<Any>
 - name String
 (string)Name of the job.- tasks List<Property Map>
 - volumes List<Property Map>
 
GetJobTaskGroupTask    
- Driver string
 - Meta Dictionary<string, object>
 - Name string
 (string)Name of the job.- Volume
Mounts List<GetJob Task Group Task Volume Mount>  
- Driver string
 - Meta map[string]interface{}
 - Name string
 (string)Name of the job.- Volume
Mounts []GetJob Task Group Task Volume Mount  
- driver String
 - meta Map<String,Object>
 - name String
 (string)Name of the job.- volume
Mounts List<GetJob Task Group Task Volume Mount>  
- driver string
 - meta {[key: string]: any}
 - name string
 (string)Name of the job.- volume
Mounts GetJob Task Group Task Volume Mount[]  
- driver str
 - meta Mapping[str, Any]
 - name str
 (string)Name of the job.- volume_
mounts Sequence[GetJob Task Group Task Volume Mount]  
- driver String
 - meta Map<Any>
 - name String
 (string)Name of the job.- volume
Mounts List<Property Map> 
GetJobTaskGroupTaskVolumeMount      
- Destination string
 - Read
Only bool - Volume string
 
- Destination string
 - Read
Only bool - Volume string
 
- destination String
 - read
Only Boolean - volume String
 
- destination string
 - read
Only boolean - volume string
 
- destination str
 - read_
only bool - volume str
 
- destination String
 - read
Only Boolean - volume String
 
GetJobTaskGroupVolume    
Package Details
- Repository
 - HashiCorp Nomad pulumi/pulumi-nomad
 - License
 - Apache-2.0
 - Notes
 - This Pulumi package is based on the 
nomadTerraform Provider.