Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. iot
  6. getJob

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.79.0
published on Monday, Sep 14, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.iot.getJob

aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.79.0
published on Monday, Sep 14, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

    Use the AWS::IoT::Job resource to declare an AWS IoT job. A job can be used to define a set of remote operations that are sent to and run on one or more devices (things or thing groups) connected to AWS IoT.

    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?: InvokeOutputOptions): Output<GetJobResult>
    def get_job(arn: Optional[str] = None,
            opts: Optional[InvokeOptions] = None) -> GetJobResult
def get_job_output(arn: pulumi.Input[Optional[str]] = None,
            opts: Optional[InvokeOutputOptions] = 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 Output<GetJobResult> Invoke(GetJobInvokeArgs args, InvokeOutputOptions opts)
}
    public static CompletableFuture<GetJobResult> getJob(GetJobArgs args, InvokeOptions options)
public static Output<GetJobResult> getJob(GetJobArgs args, InvokeOptions options)
public static Output<GetJobResult> getJob(GetJobArgs args, InvokeOutputOptions options)

    fn::invoke:
  function: aws-native:iot:getJob
  arguments:
    # arguments dictionary
    data "aws-native_iot_get_job" "name" {
    # arguments
}

    The following arguments are supported:

    Arn string
    The Amazon Resource Name (ARN) of the job.
    Arn string
    The Amazon Resource Name (ARN) of the job.
    arn string
    The Amazon Resource Name (ARN) of the job.
    arn String
    The Amazon Resource Name (ARN) of the job.
    arn string
    The Amazon Resource Name (ARN) of the job.
    arn str
    The Amazon Resource Name (ARN) of the job.
    arn String
    The Amazon Resource Name (ARN) of the job.

    getJob Result

    The following output properties are available:

    AbortConfig JobAbortConfig
    Arn string
    The Amazon Resource Name (ARN) of the job.
    CreatedAt string
    The time when the job was created, in ISO 8601 date-time format.
    Description string
    A short text description of the job.
    JobExecutionsRolloutConfig JobExecutionsRolloutConfig
    PresignedUrlConfig JobPresignedUrlConfig
    Tags Tag
    Metadata which can be used to manage the job.
    TimeoutConfig JobTimeoutConfig
    abort_config object
    arn string
    The Amazon Resource Name (ARN) of the job.
    created_at string
    The time when the job was created, in ISO 8601 date-time format.
    description string
    A short text description of the job.
    job_executions_rollout_config object
    presigned_url_config object
    tags list(object)
    Metadata which can be used to manage the job.
    timeout_config object
    abortConfig JobAbortConfig
    arn String
    The Amazon Resource Name (ARN) of the job.
    createdAt String
    The time when the job was created, in ISO 8601 date-time format.
    description String
    A short text description of the job.
    jobExecutionsRolloutConfig JobExecutionsRolloutConfig
    presignedUrlConfig JobPresignedUrlConfig
    tags List<Tag>
    Metadata which can be used to manage the job.
    timeoutConfig JobTimeoutConfig
    abortConfig JobAbortConfig
    arn string
    The Amazon Resource Name (ARN) of the job.
    createdAt string
    The time when the job was created, in ISO 8601 date-time format.
    description string
    A short text description of the job.
    jobExecutionsRolloutConfig JobExecutionsRolloutConfig
    presignedUrlConfig JobPresignedUrlConfig
    tags Tag[]
    Metadata which can be used to manage the job.
    timeoutConfig JobTimeoutConfig
    abort_config JobAbortConfig
    arn str
    The Amazon Resource Name (ARN) of the job.
    created_at str
    The time when the job was created, in ISO 8601 date-time format.
    description str
    A short text description of the job.
    job_executions_rollout_config JobExecutionsRolloutConfig
    presigned_url_config JobPresignedUrlConfig
    tags Sequence[root_Tag]
    Metadata which can be used to manage the job.
    timeout_config JobTimeoutConfig
    abortConfig Property Map
    arn String
    The Amazon Resource Name (ARN) of the job.
    createdAt String
    The time when the job was created, in ISO 8601 date-time format.
    description String
    A short text description of the job.
    jobExecutionsRolloutConfig Property Map
    presignedUrlConfig Property Map
    tags List<Property Map>
    Metadata which can be used to manage the job.
    timeoutConfig Property Map

    Supporting Types

    JobAbortConfig

    CriteriaList List<Pulumi.AwsNative.IoT.Inputs.JobAbortCriteria>
    The list of criteria that determine when and how to abort the job.
    CriteriaList []JobAbortCriteria
    The list of criteria that determine when and how to abort the job.
    criteria_list list(object)
    The list of criteria that determine when and how to abort the job.
    criteriaList List<JobAbortCriteria>
    The list of criteria that determine when and how to abort the job.
    criteriaList JobAbortCriteria[]
    The list of criteria that determine when and how to abort the job.
    criteria_list Sequence[JobAbortCriteria]
    The list of criteria that determine when and how to abort the job.
    criteriaList List<Property Map>
    The list of criteria that determine when and how to abort the job.

    JobAbortCriteria

    Action Pulumi.AwsNative.IoT.JobAbortCriteriaAction
    The type of job action to take to initiate the job abort.
    FailureType Pulumi.AwsNative.IoT.JobAbortCriteriaFailureType
    The type of job execution failures that can initiate a job abort.
    MinNumberOfExecutedThings int
    The minimum number of things which must receive job execution notifications before the job can be aborted.
    ThresholdPercentage double
    The minimum percentage of job execution failures that must occur to initiate the job abort.
    Action JobAbortCriteriaAction
    The type of job action to take to initiate the job abort.
    FailureType JobAbortCriteriaFailureType
    The type of job execution failures that can initiate a job abort.
    MinNumberOfExecutedThings int
    The minimum number of things which must receive job execution notifications before the job can be aborted.
    ThresholdPercentage float64
    The minimum percentage of job execution failures that must occur to initiate the job abort.
    action "CANCEL"
    The type of job action to take to initiate the job abort.
    failure_type "FAILED" | "REJECTED" | "TIMED_OUT" | "ALL"
    The type of job execution failures that can initiate a job abort.
    min_number_of_executed_things number
    The minimum number of things which must receive job execution notifications before the job can be aborted.
    threshold_percentage number
    The minimum percentage of job execution failures that must occur to initiate the job abort.
    action JobAbortCriteriaAction
    The type of job action to take to initiate the job abort.
    failureType JobAbortCriteriaFailureType
    The type of job execution failures that can initiate a job abort.
    minNumberOfExecutedThings Integer
    The minimum number of things which must receive job execution notifications before the job can be aborted.
    thresholdPercentage Double
    The minimum percentage of job execution failures that must occur to initiate the job abort.
    action JobAbortCriteriaAction
    The type of job action to take to initiate the job abort.
    failureType JobAbortCriteriaFailureType
    The type of job execution failures that can initiate a job abort.
    minNumberOfExecutedThings number
    The minimum number of things which must receive job execution notifications before the job can be aborted.
    thresholdPercentage number
    The minimum percentage of job execution failures that must occur to initiate the job abort.
    action JobAbortCriteriaAction
    The type of job action to take to initiate the job abort.
    failure_type JobAbortCriteriaFailureType
    The type of job execution failures that can initiate a job abort.
    min_number_of_executed_things int
    The minimum number of things which must receive job execution notifications before the job can be aborted.
    threshold_percentage float
    The minimum percentage of job execution failures that must occur to initiate the job abort.
    action "CANCEL"
    The type of job action to take to initiate the job abort.
    failureType "FAILED" | "REJECTED" | "TIMED_OUT" | "ALL"
    The type of job execution failures that can initiate a job abort.
    minNumberOfExecutedThings Number
    The minimum number of things which must receive job execution notifications before the job can be aborted.
    thresholdPercentage Number
    The minimum percentage of job execution failures that must occur to initiate the job abort.

    JobAbortCriteriaAction

    JobAbortCriteriaFailureType

    JobExecutionsRolloutConfig

    ExponentialRate Pulumi.AwsNative.IoT.Inputs.JobExponentialRolloutRate
    MaximumPerMinute int
    The maximum number of things that will be notified of a pending job, per minute. This parameter allows you to create a staged rollout.
    ExponentialRate JobExponentialRolloutRate
    MaximumPerMinute int
    The maximum number of things that will be notified of a pending job, per minute. This parameter allows you to create a staged rollout.
    exponential_rate object
    maximum_per_minute number
    The maximum number of things that will be notified of a pending job, per minute. This parameter allows you to create a staged rollout.
    exponentialRate JobExponentialRolloutRate
    maximumPerMinute Integer
    The maximum number of things that will be notified of a pending job, per minute. This parameter allows you to create a staged rollout.
    exponentialRate JobExponentialRolloutRate
    maximumPerMinute number
    The maximum number of things that will be notified of a pending job, per minute. This parameter allows you to create a staged rollout.
    exponential_rate JobExponentialRolloutRate
    maximum_per_minute int
    The maximum number of things that will be notified of a pending job, per minute. This parameter allows you to create a staged rollout.
    exponentialRate Property Map
    maximumPerMinute Number
    The maximum number of things that will be notified of a pending job, per minute. This parameter allows you to create a staged rollout.

    JobExponentialRolloutRate

    BaseRatePerMinute int
    The minimum number of things that will be notified of a pending job, per minute at the start of job rollout.
    IncrementFactor double
    The exponential factor to increase the rate of rollout for a job.
    RateIncreaseCriteria Pulumi.AwsNative.IoT.Inputs.JobRateIncreaseCriteria
    BaseRatePerMinute int
    The minimum number of things that will be notified of a pending job, per minute at the start of job rollout.
    IncrementFactor float64
    The exponential factor to increase the rate of rollout for a job.
    RateIncreaseCriteria JobRateIncreaseCriteria
    base_rate_per_minute number
    The minimum number of things that will be notified of a pending job, per minute at the start of job rollout.
    increment_factor number
    The exponential factor to increase the rate of rollout for a job.
    rate_increase_criteria object
    baseRatePerMinute Integer
    The minimum number of things that will be notified of a pending job, per minute at the start of job rollout.
    incrementFactor Double
    The exponential factor to increase the rate of rollout for a job.
    rateIncreaseCriteria JobRateIncreaseCriteria
    baseRatePerMinute number
    The minimum number of things that will be notified of a pending job, per minute at the start of job rollout.
    incrementFactor number
    The exponential factor to increase the rate of rollout for a job.
    rateIncreaseCriteria JobRateIncreaseCriteria
    base_rate_per_minute int
    The minimum number of things that will be notified of a pending job, per minute at the start of job rollout.
    increment_factor float
    The exponential factor to increase the rate of rollout for a job.
    rate_increase_criteria JobRateIncreaseCriteria
    baseRatePerMinute Number
    The minimum number of things that will be notified of a pending job, per minute at the start of job rollout.
    incrementFactor Number
    The exponential factor to increase the rate of rollout for a job.
    rateIncreaseCriteria Property Map

    JobPresignedUrlConfig

    ExpiresInSec int
    How long (in seconds) pre-signed URLs are valid. Valid values are 60 - 3600, the default value is 3600 seconds.
    RoleArn string
    The ARN of an IAM role that grants permission to download files from the S3 bucket where the job data/updates are stored.
    ExpiresInSec int
    How long (in seconds) pre-signed URLs are valid. Valid values are 60 - 3600, the default value is 3600 seconds.
    RoleArn string
    The ARN of an IAM role that grants permission to download files from the S3 bucket where the job data/updates are stored.
    expires_in_sec number
    How long (in seconds) pre-signed URLs are valid. Valid values are 60 - 3600, the default value is 3600 seconds.
    role_arn string
    The ARN of an IAM role that grants permission to download files from the S3 bucket where the job data/updates are stored.
    expiresInSec Integer
    How long (in seconds) pre-signed URLs are valid. Valid values are 60 - 3600, the default value is 3600 seconds.
    roleArn String
    The ARN of an IAM role that grants permission to download files from the S3 bucket where the job data/updates are stored.
    expiresInSec number
    How long (in seconds) pre-signed URLs are valid. Valid values are 60 - 3600, the default value is 3600 seconds.
    roleArn string
    The ARN of an IAM role that grants permission to download files from the S3 bucket where the job data/updates are stored.
    expires_in_sec int
    How long (in seconds) pre-signed URLs are valid. Valid values are 60 - 3600, the default value is 3600 seconds.
    role_arn str
    The ARN of an IAM role that grants permission to download files from the S3 bucket where the job data/updates are stored.
    expiresInSec Number
    How long (in seconds) pre-signed URLs are valid. Valid values are 60 - 3600, the default value is 3600 seconds.
    roleArn String
    The ARN of an IAM role that grants permission to download files from the S3 bucket where the job data/updates are stored.

    JobRateIncreaseCriteria

    NumberOfNotifiedThings int
    The threshold for number of notified things that will initiate the increase in rate of rollout.
    NumberOfSucceededThings int
    The threshold for number of succeeded things that will initiate the increase in rate of rollout.
    NumberOfNotifiedThings int
    The threshold for number of notified things that will initiate the increase in rate of rollout.
    NumberOfSucceededThings int
    The threshold for number of succeeded things that will initiate the increase in rate of rollout.
    number_of_notified_things number
    The threshold for number of notified things that will initiate the increase in rate of rollout.
    number_of_succeeded_things number
    The threshold for number of succeeded things that will initiate the increase in rate of rollout.
    numberOfNotifiedThings Integer
    The threshold for number of notified things that will initiate the increase in rate of rollout.
    numberOfSucceededThings Integer
    The threshold for number of succeeded things that will initiate the increase in rate of rollout.
    numberOfNotifiedThings number
    The threshold for number of notified things that will initiate the increase in rate of rollout.
    numberOfSucceededThings number
    The threshold for number of succeeded things that will initiate the increase in rate of rollout.
    number_of_notified_things int
    The threshold for number of notified things that will initiate the increase in rate of rollout.
    number_of_succeeded_things int
    The threshold for number of succeeded things that will initiate the increase in rate of rollout.
    numberOfNotifiedThings Number
    The threshold for number of notified things that will initiate the increase in rate of rollout.
    numberOfSucceededThings Number
    The threshold for number of succeeded things that will initiate the increase in rate of rollout.

    JobTimeoutConfig

    InProgressTimeoutInMinutes int
    Specifies the amount of time, in minutes, this device has to finish execution of this job. The timeout interval can be anywhere between 1 minute and 7 days (1 to 10080 minutes).
    InProgressTimeoutInMinutes int
    Specifies the amount of time, in minutes, this device has to finish execution of this job. The timeout interval can be anywhere between 1 minute and 7 days (1 to 10080 minutes).
    in_progress_timeout_in_minutes number
    Specifies the amount of time, in minutes, this device has to finish execution of this job. The timeout interval can be anywhere between 1 minute and 7 days (1 to 10080 minutes).
    inProgressTimeoutInMinutes Integer
    Specifies the amount of time, in minutes, this device has to finish execution of this job. The timeout interval can be anywhere between 1 minute and 7 days (1 to 10080 minutes).
    inProgressTimeoutInMinutes number
    Specifies the amount of time, in minutes, this device has to finish execution of this job. The timeout interval can be anywhere between 1 minute and 7 days (1 to 10080 minutes).
    in_progress_timeout_in_minutes int
    Specifies the amount of time, in minutes, this device has to finish execution of this job. The timeout interval can be anywhere between 1 minute and 7 days (1 to 10080 minutes).
    inProgressTimeoutInMinutes Number
    Specifies the amount of time, in minutes, this device has to finish execution of this job. The timeout interval can be anywhere between 1 minute and 7 days (1 to 10080 minutes).

    Tag

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.79.0
    published on Monday, Sep 14, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial