/things/{thingName}/jobs/{jobId}/executionNumber/{executionNumber}

The AWS IoT Wireless multi-region endpoint

https://api.iotwireless.{region}.amazonaws.com

DELETE

Deletes a job execution.

Requires permission to access the DeleteJobExecution action.

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request DELETE 'https://api.iotwireless.{region}.amazonaws.com/things//jobs//executionNumber/'

Response Example

200 - Example 1

{}

Request

Path Params

jobId

string

required

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

thingName

string

required

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

executionNumber

integer

required

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.

Query Params

force

string

optional

(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.

namespaceId

string

optional

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/

Responses

🟢200Success

application/json

Body

object {0}

🟠480InvalidRequestException

🟠481InvalidStateTransitionException

🟠482ResourceNotFoundException

🟠483ThrottlingException

🟠484ServiceUnavailableException

Modified at 2022-09-10 23:12:15

/certificates/{certificateId}

/policies/{policyName}/version/{policyVersionId}