Struct aws_sdk_iot::client::fluent_builders::DeleteJobExecution

pub struct DeleteJobExecution<C = DynConnector, M = DefaultMiddleware, R = Standard> { /* fields omitted */ }

Fluent builder constructing a request to DeleteJobExecution.

Deletes a job execution.

Requires permission to access the DeleteJobExecution action.

Implementations

impl<C, M, R> DeleteJobExecution<C, M, R> where
    C: SmithyConnector,
    M: SmithyMiddleware<C>,
    R: NewRequestPolicy, 

pub async fn send(
    self
) -> Result<DeleteJobExecutionOutput, SdkError<DeleteJobExecutionError>> where
    R::Policy: SmithyRetryPolicy<DeleteJobExecutionInputOperationOutputAlias, DeleteJobExecutionOutput, DeleteJobExecutionError, DeleteJobExecutionInputOperationRetryAlias>, 

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn job_id(self, inp: impl Into<String>) -> Self

The ID of the job whose execution on a particular device will be deleted.

pub fn set_job_id(self, input: Option<String>) -> Self

The ID of the job whose execution on a particular device will be deleted.

pub fn thing_name(self, inp: impl Into<String>) -> Self

The name of the thing whose job execution will be deleted.

pub fn set_thing_name(self, input: Option<String>) -> Self

The name of the thing whose job execution will be deleted.

pub fn execution_number(self, inp: i64) -> Self

The ID of the job execution to be deleted. The executionNumber refers to the execution of a particular job on a particular device.

Note that once a job execution is deleted, the executionNumber may be reused by IoT, so be sure you get and use the correct value here.

pub fn set_execution_number(self, input: Option<i64>) -> Self

The ID of the job execution to be deleted. The executionNumber refers to the execution of a particular job on a particular device.

Note that once a job execution is deleted, the executionNumber may be reused by IoT, so be sure you get and use the correct value here.

pub fn force(self, inp: bool) -> Self

(Optional) When true, you can delete a job execution which is "IN_PROGRESS". Otherwise, you can only delete a job execution which is in a terminal state ("SUCCEEDED", "FAILED", "REJECTED", "REMOVED" or "CANCELED") or an exception will occur. The default is false.

Deleting a job execution which is "IN_PROGRESS", will cause the device to be unable to access job information or update the job execution status. Use caution and ensure that the device is able to recover to a valid state.

pub fn set_force(self, input: Option<bool>) -> Self

(Optional) When true, you can delete a job execution which is "IN_PROGRESS". Otherwise, you can only delete a job execution which is in a terminal state ("SUCCEEDED", "FAILED", "REJECTED", "REMOVED" or "CANCELED") or an exception will occur. The default is false.

Deleting a job execution which is "IN_PROGRESS", will cause the device to be unable to access job information or update the job execution status. Use caution and ensure that the device is able to recover to a valid state.

pub fn namespace_id(self, inp: impl Into<String>) -> Self

The namespace used to indicate that a job is a customer-managed job.

When you specify a value for this parameter, Amazon Web Services IoT Core sends jobs notifications to MQTT topics that contain the value in the following format.

$aws/things/THING_NAME/jobs/JOB_ID/notify-namespace-NAMESPACE_ID/

The namespaceId feature is in public preview.

pub fn set_namespace_id(self, input: Option<String>) -> Self

The namespace used to indicate that a job is a customer-managed job.

When you specify a value for this parameter, Amazon Web Services IoT Core sends jobs notifications to MQTT topics that contain the value in the following format.

$aws/things/THING_NAME/jobs/JOB_ID/notify-namespace-NAMESPACE_ID/

The namespaceId feature is in public preview.

Trait Implementations

impl<C: Debug, M: Debug, R: Debug> Debug for DeleteJobExecution<C, M, R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.