aws_sdk_iotjobsdataplane/client/start_next_pending_job_execution.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3 /// Constructs a fluent builder for the [`StartNextPendingJobExecution`](crate::operation::start_next_pending_job_execution::builders::StartNextPendingJobExecutionFluentBuilder) operation.
4 ///
5 /// - The fluent builder is configurable:
6 /// - [`thing_name(impl Into<String>)`](crate::operation::start_next_pending_job_execution::builders::StartNextPendingJobExecutionFluentBuilder::thing_name) / [`set_thing_name(Option<String>)`](crate::operation::start_next_pending_job_execution::builders::StartNextPendingJobExecutionFluentBuilder::set_thing_name):<br>required: **true**<br><p>The name of the thing associated with the device.</p><br>
7 /// - [`status_details(impl Into<String>, impl Into<String>)`](crate::operation::start_next_pending_job_execution::builders::StartNextPendingJobExecutionFluentBuilder::status_details) / [`set_status_details(Option<HashMap::<String, String>>)`](crate::operation::start_next_pending_job_execution::builders::StartNextPendingJobExecutionFluentBuilder::set_status_details):<br>required: **false**<br><p>A collection of name/value pairs that describe the status of the job execution. If not specified, the statusDetails are unchanged.</p> <p>The maximum length of the value in the name/value pair is 1,024 characters.</p><br>
8 /// - [`step_timeout_in_minutes(i64)`](crate::operation::start_next_pending_job_execution::builders::StartNextPendingJobExecutionFluentBuilder::step_timeout_in_minutes) / [`set_step_timeout_in_minutes(Option<i64>)`](crate::operation::start_next_pending_job_execution::builders::StartNextPendingJobExecutionFluentBuilder::set_step_timeout_in_minutes):<br>required: **false**<br><p>Specifies the amount of time this device has to finish execution of this job. If the job execution status is not set to a terminal state before this timer expires, or before the timer is reset (by calling <code>UpdateJobExecution</code>, setting the status to <code>IN_PROGRESS</code>, and specifying a new timeout value in field <code>stepTimeoutInMinutes</code>) the job execution status will be automatically set to <code>TIMED_OUT</code>. Note that setting the step timeout has no effect on the in progress timeout that may have been specified when the job was created (<code>CreateJob</code> using field <code>timeoutConfig</code>).</p> <p>Valid values for this parameter range from 1 to 10080 (1 minute to 7 days).</p><br>
9 /// - On success, responds with [`StartNextPendingJobExecutionOutput`](crate::operation::start_next_pending_job_execution::StartNextPendingJobExecutionOutput) with field(s):
10 /// - [`execution(Option<JobExecution>)`](crate::operation::start_next_pending_job_execution::StartNextPendingJobExecutionOutput::execution): <p>A JobExecution object.</p>
11 /// - On failure, responds with [`SdkError<StartNextPendingJobExecutionError>`](crate::operation::start_next_pending_job_execution::StartNextPendingJobExecutionError)
12 pub fn start_next_pending_job_execution(
13 &self,
14 ) -> crate::operation::start_next_pending_job_execution::builders::StartNextPendingJobExecutionFluentBuilder {
15 crate::operation::start_next_pending_job_execution::builders::StartNextPendingJobExecutionFluentBuilder::new(self.handle.clone())
16 }
17}