Asset model topics Amazon IoT Device Defender topics Amazon IoT Core Device Location topics Event topics Fleet provisioning topics Job topics Rule topics Secure tunneling topics Shadow topics MQTT-based file delivery topics Reserved topic ARN

Reserved topics

Topics that begin with a dollar sign ($) are reserved for use by Amazon IoT. You can subscribe and publish to these reserved topics as they allow; however, you can't create new topics that begin with a dollar sign. Unsupported publish or subscribe operations to reserved topics can result in a terminated connection.

Asset model topics

Topic	Client operations allowed	Description
$aws/sitewise/asset-models/`assetModelId`/assets/`assetId`/properties/`propertyId`	Subscribe	Amazon IoT SiteWise publishes asset property notifications to this topic. For more information, see Interacting with other Amazon services in the Amazon IoT SiteWise User Guide.

Amazon IoT Device Defender topics

These messages support response buffers in Concise Binary Object Representation (CBOR) format and JavaScript Object Notation (JSON), depending on the payload-format of the topic. Amazon IoT Device Defender topics only support MQTT publish.

`payload-format`	Response format data type
cbor	Concise Binary Object Representation (CBOR)
json	JavaScript Object Notation (JSON)

For more information, see Sending metrics from devices.

Topic	Allowed operations	Description
$aws/things/`thingName`/defender/metrics/`payload-format`	Publish	Amazon IoT Device Defender agents publish metrics to this topic. For more information, see Sending metrics from devices.
$aws/things/`thingName`/defender/metrics/`payload-format`/accepted	Subscribe	Amazon IoT publishes to this topic after a Amazon IoT Device Defender agent publishes a successful message to $aws/things/`thingName`/defender/metrics/`payload-format`. For more information, see Sending metrics from devices.
$aws/things/`thingName`/defender/metrics/`payload-format`/rejected	Subscribe	Amazon IoT publishes to this topic after a Amazon IoT Device Defender agent publishes an unsuccessful message to $aws/things/`thingName`/defender/metrics/`payload-format`. For more information, see Sending metrics from devices.

Amazon IoT Core Device Location topics

Amazon IoT Core Device Location can resolve the measurement data from your device and provide an estimated location of your IoT devices. The measurement data from the device can include GNSS, Wi-Fi, cellular, and IP address. Amazon IoT Core Device Location then chooses the measurement type that provides the best accuracy and solves the device location information. For more information, see Amazon IoT Core Device Location and Resolving device location using Amazon IoT Core Device Location MQTT topics.

Topic	Allowed operations	Description
$aws/device_location/`customer_device_id`/get_position_estimate	Publish	A device publishes to this topic to get the scanned raw measurement data to be resolved by Amazon IoT Core Device Location.
$aws/device_location/`customer_device_id`/get_position_estimate/accepted	Subscribe	Amazon IoT Core Device Location publishes to this topic after it has resolved the device location successfully.
$aws/device_location/`customer_device_id`/get_position_estimate/rejected	Subscribe	Amazon IoT Core Device Location publishes to this topic when it is unable to resolve the device location successfully due to 4xx errors.

Event topics

Note

For more information about reserved MQTT topics for LoRaWAN events, see Connection status events.

Topic	Client operations allowed	Description
$aws/events/certificates/registered/`caCertificateId`	Subscribe	Amazon IoT publishes this message when Amazon IoT automatically registers a certificate and when a client presents a certificate with the `PENDING_ACTIVATION` status. For more information, see Configure the first connection by a client for automatic registration.
$aws/events/job/`jobID`/canceled	Subscribe	Amazon IoT publishes this message when a job is canceled. For more information, see Jobs events.
$aws/events/job/`jobID`/cancellation_in_progress	Subscribe	Amazon IoT publishes this message when a job cancellation is in progress. For more information, see Jobs events.
$aws/events/job/`jobID`/completed	Subscribe	Amazon IoT publishes this message when a job has completed. For more information, see Jobs events.
$aws/events/job/`jobID`/deleted	Subscribe	Amazon IoT publishes this message when a job is deleted. For more information, see Jobs events.
$aws/events/job/`jobID`/deletion_in_progress	Subscribe	Amazon IoT publishes this message when a job deletion is in progress. For more information, see Jobs events.
$aws/events/jobExecution/`jobID`/canceled	Subscribe	Amazon IoT publishes this message when a job execution is canceled. For more information, see Jobs events.
$aws/events/jobExecution/`jobID`/deleted	Subscribe	Amazon IoT publishes this message when a job execution is deleted. For more information, see Jobs events.
$aws/events/jobExecution/`jobID`/failed	Subscribe	Amazon IoT publishes this message when a job execution has failed. For more information, see Jobs events.
$aws/events/jobExecution/`jobID`/rejected	Subscribe	Amazon IoT publishes this message when a job execution was rejected. For more information, see Jobs events.
$aws/events/jobExecution/`jobID`/removed	Subscribe	Amazon IoT publishes this message when a job execution was removed. For more information, see Jobs events.
$aws/events/jobExecution/`jobID`/succeeded	Subscribe	Amazon IoT publishes this message when a job execution succeeded. For more information, see Jobs events.
$aws/events/jobExecution/`jobID`/timed_out	Subscribe	Amazon IoT publishes this message when a job execution timed out. For more information, see Jobs events.
$aws/events/presence/connected/`clientId`	Subscribe	Amazon IoT publishes to this topic when an MQTT client with the specified client ID connects to Amazon IoT. For more information, see Connect/Disconnect events.
$aws/events/presence/disconnected/`clientId`	Subscribe	Amazon IoT publishes to this topic when an MQTT client with the specified client ID disconnects to Amazon IoT. For more information, see Connect/Disconnect events.
$aws/events/subscriptions/subscribed/`clientId`	Subscribe	Amazon IoT publishes to this topic when an MQTT client with the specified client ID subscribes to an MQTT topic. For more information, see Subscribe/Unsubscribe events.
$aws/events/subscriptions/unsubscribed/`clientId`	Subscribe	Amazon IoT publishes to this topic when an MQTT client with the specified client ID unsubscribes to an MQTT topic. For more information, see Subscribe/Unsubscribe events.
$aws/events/thing/`thingName`/created	Subscribe	Amazon IoT publishes to this topic when the `thingName` thing is created. For more information, see Registry events.
$aws/events/thing/`thingName`/updated	Subscribe	Amazon IoT publishes to this topic when the `thingName` thing is updated. For more information, see Registry events.
$aws/events/thing/`thingName`/deleted	Subscribe	Amazon IoT publishes to this topic when the `thingName` thing is deleted. For more information, see Registry events.
$aws/events/thingGroup/`thingGroupName`/created	Subscribe	Amazon IoT publishes to this topic when thing group `thingGroupName` is created. For more information, see Registry events.
$aws/events/thingGroup/`thingGroupName`/updated	Subscribe	Amazon IoT publishes to this topic when thing group `thingGroupName` is updated. For more information, see Registry events.
$aws/events/thingGroup/`thingGroupName`/deleted	Subscribe	Amazon IoT publishes to this topic when thing group `thingGroupName` is deleted. For more information, see Registry events.
$aws/events/thingType/`thingTypeName`/created	Subscribe	Amazon IoT publishes to this topic when the `thingTypeName` thing type is created. For more information, see Registry events.
$aws/events/thingType/`thingTypeName`/updated	Subscribe	Amazon IoT publishes to this topic when the `thingTypeName` thing type is updated. For more information, see Registry events.
$aws/events/thingType/`thingTypeName`/deleted	Subscribe	Amazon IoT publishes to this topic when the `thingTypeName` thing type is deleted. For more information, see Registry events.
$aws/events/thingTypeAssociation/thing/`thingName`/`thingTypeName`	Subscribe	Amazon IoT publishes to this topic when thing `thingName` is associated with or disassociated from thing type `thingTypeName`. For more information, see Registry events.
$aws/events/thingGroupMembership/thingGroup/`thingGroupName`/thing/`thingName`/added	Subscribe	Amazon IoT publishes to this topic when thing `thingName` is added to thing group `thingGroupName`. For more information, see Registry events.
$aws/events/thingGroupMembership/thingGroup/`thingGroupName`/thing/`thingName`/removed	Subscribe	Amazon IoT publishes to this topic when thing `thingName` is removed from thing group `thingGroupName`. For more information, see Registry events.
$aws/events/thingGroupHierarchy/thingGroup/`parentThingGroupName`/childThingGroup/`childThingGroupName`/added	Subscribe	Amazon IoT publishes to this topic when thing group `childThingGroupName` is added to thing group `parentThingGroupName`. For more information, see Registry events.
$aws/events/thingGroupHierarchy/thingGroup/`parentThingGroupName`/childThingGroup/`childThingGroupName`/removed	Subscribe	Amazon IoT publishes to this topic when thing group `childThingGroupName` is removed from thing group `parentThingGroupName`. For more information, see Registry events.

Fleet provisioning topics

Note

The client operations noted as Receive in this table indicate topics that Amazon IoT publishes directly to the client that requested it, whether the client has subscribed to the topic or not. Clients should expect to receive these response messages even if they haven't subscribed to them. These response messages don't pass through the message broker and they can't be subscribed to by other clients or rules.

These messages support response buffers in Concise Binary Object Representation (CBOR) format and JavaScript Object Notation (JSON), depending on the payload-format of the topic.

`payload-format`	Response format data type
cbor	Concise Binary Object Representation (CBOR)
json	JavaScript Object Notation (JSON)

For more information, see Device provisioning MQTT API.

Topic	Client operations allowed	Description
$aws/certificates/create/`payload-format`	Publish	Publish to this topic to create a certificate from a certificate signing request (CSR).
$aws/certificates/create/`payload-format`/accepted	Subscribe, Receive	Amazon IoT publishes to this topic after a successful call to $aws/certificates/create/`payload-format`.
$aws/certificates/create/`payload-format`/rejected	Subscribe, Receive	Amazon IoT publishes to this topic after an unsuccessful call to $aws/certificates/create/`payload-format`.
$aws/certificates/create-from-csr/`payload-format`	Publish	Publishes to this topic to create a certificate from a CSR.
$aws/certificates/create-from-csr/`payload-format`/accepted	Subscribe, Receive	Amazon IoT publishes to this topic a successful call to $aws/certificates/create-from-csr/`payload-format`.
$aws/certificates/create-from-csr/`payload-format`/rejected	Subscribe, Receive	Amazon IoT publishes to this topic an unsuccessful call to $aws/certificates/create-from-csr/`payload-format`.
$aws/provisioning-templates/`templateName`/provision/`payload-format`	Publish	Publish to this topic to register a thing.
$aws/provisioning-templates/`templateName`/provision/`payload-format`/accepted	Subscribe, Receive	Amazon IoT publishes to this topic after a successful call to $aws/provisioning-templates/`templateName`/provision/`payload-format`.
$aws/provisioning-templates/`templateName`/provision/`payload-format`/rejected	Subscribe, Receive	Amazon IoT publishes to this topic after an unsuccessful call to $aws/provisioning-templates/`templateName`/provision/`payload-format`.

Job topics

Note

These response messages don't pass through the message broker and they can't be subscribed to by other clients or rules. To subscribe to job activity related messages, use the notify and notify-next topics.

When subscribing to the job and jobExecution event topics for your fleet-monitoring solution, you must first enable job and job execution events to receive any events on the cloud side.

For more information, see Jobs device MQTT API operations.

Topic	Client operations allowed	Description
$aws/things/`thingName`/jobs/get	Publish	Devices publish a message to this topic to make a `GetPendingJobExecutions` request. For more information, see Jobs device MQTT API operations.
$aws/things/`thingName`/jobs/get/accepted	Subscribe, Receive	Devices subscribe to this topic to receive successful responses from a `GetPendingJobExecutions` request. For more information, see Jobs device MQTT API operations.
$aws/things/`thingName`/jobs/get/rejected	Subscribe, Receive	Devices subscribe to this topic to receive a response when a `GetPendingJobExecutions` request is rejected. For more information, see Jobs device MQTT API operations.
$aws/things/`thingName`/jobs/start-next	Publish	Devices publish a message to this topic to make a `StartNextPendingJobExecution` request. For more information, see Jobs device MQTT API operations.
$aws/things/`thingName`/jobs/start-next/accepted	Subscribe, Receive	Devices subscribe to this topic to receive successful responses to a `StartNextPendingJobExecution` request. For more information, see Jobs device MQTT API operations.
$aws/things/`thingName`/jobs/start-next/rejected	Subscribe, Receive	Devices subscribe to this topic to receive a response when a `StartNextPendingJobExecution` request is rejected. For more information, see Jobs device MQTT API operations.
$aws/things/`thingName`/jobs/`jobId`/get	Publish	Devices publish a message to this topic to make a `DescribeJobExecution` request. For more information, see Jobs device MQTT API operations.
$aws/things/`thingName`/jobs/`jobId`/get/accepted	Subscribe, Receive	Devices subscribe to this topic to receive successful responses to a `DescribeJobExecution` request. For more information, see Jobs device MQTT API operations.
$aws/things/`thingName`/jobs/`jobId`/get/rejected	Subscribe, Receive	Devices subscribe to this topic to receive a response when a `DescribeJobExecution` request is rejected. For more information, see Jobs device MQTT API operations.
$aws/things/`thingName`/jobs/`jobId`/update	Publish	Devices publish a message to this topic to make an `UpdateJobExecution` request. For more information, see Jobs device MQTT API operations.
$aws/things/`thingName`/jobs/`jobId`/update/accepted	Subscribe, Receive	Devices subscribe to this topic to receive successful responses to an `UpdateJobExecution` request. For more information, see Jobs device MQTT API operations. Note Only the device that publishes to $aws/things/`thingName`/jobs/`jobId`/update receives messages on this topic.
$aws/things/`thingName`/jobs/`jobId`/update/rejected	Subscribe, Receive	Devices subscribe to this topic to receive a response when an `UpdateJobExecution` request is rejected. For more information, see Jobs device MQTT API operations. Note Only the device that publishes to $aws/things/`thingName`/jobs/`jobId`/update receives messages on this topic.
$aws/things/`thingName`/jobs/notify	Subscribe, Receive	Devices subscribe to this topic to receive notifications when a job execution is added or removed to the list of pending executions for a thing. For more information, see Jobs device MQTT API operations.
$aws/things/`thingName`/jobs/notify-next	Subscribe, Receive	Devices subscribe to this topic to receive notifications when the next pending job execution for the thing is changed. For more information, see Jobs device MQTT API operations.
$aws/events/job/`jobId`/completed	Subscribe	The Jobs service publishes an event on this topic when a job completes. For more information, see Jobs events.
$aws/events/job/`jobId`/canceled	Subscribe	The Jobs service publishes an event on this topic when a job is canceled. For more information, see Jobs events.
$aws/events/job/`jobId`/deleted	Subscribe	The Jobs service publishes an event on this topic when a job is deleted. For more information, see Jobs events.
$aws/events/job/`jobId`/cancellation_in_progress	Subscribe	The Jobs service publishes an event on this topic when a job cancellation begins. For more information, see Jobs events.
$aws/events/job/`jobId`/deletion_in_progress	Subscribe	The Jobs service publishes an event on this topic when a job deletion begins. For more information, see Jobs events.
$aws/events/jobExecution/`jobId`/succeeded	Subscribe	The Jobs service publishes an event on this topic when job execution succeeds. For more information, see Jobs events.
$aws/events/jobExecution/`jobId`/failed	Subscribe	The Jobs service publishes an event on this topic when a job execution fails. For more information, see Jobs events.
$aws/events/jobExecution/`jobId`/rejected	Subscribe	The Jobs service publishes an event on this topic when a job execution is rejected. For more information, see Jobs events.
$aws/events/jobExecution/`jobId`/canceled	Subscribe	The Jobs service publishes an event on this topic when a job execution is canceled. For more information, see Jobs events.
$aws/events/jobExecution/`jobId`/timed_out	Subscribe	The Jobs service publishes an event on this topic when a job execution times out. For more information, see Jobs events.
$aws/events/jobExecution/`jobId`/removed	Subscribe	The Jobs service publishes an event on this topic when a job execution is removed. For more information, see Jobs events.
$aws/events/jobExecution/`jobId`/deleted	Subscribe	The Jobs service publishes an event on this topic when a job execution is deleted. For more information, see Jobs events.

Rule topics

Topic	Client operations allowed	Description
$aws/rules/`ruleName`	Publish	A device or an application publishes to this topic to trigger rules directly. For more information, see Reducing messaging costs with Basic Ingest.

Secure tunneling topics

Topic	Client operations allowed	Description
$aws/things/`thing-name`/tunnels/notify	Subscribe	Amazon IoT publishes this message for an IoT agent to start a local proxy on the remote device. For more information, see IoT agent snippet.

Shadow topics

The topics in this section are used by named and unnamed shadows. The topics used by each differ only in the topic prefix. This table shows the topic prefix used by each shadow type.

`ShadowTopicPrefix` value	Shadow type
$aws/things/`thingName`/shadow	Unnamed (classic) shadow
$aws/things/`thingName`/shadow/name/`shadowName`	Named shadow

To create a complete topic, select the ShadowTopicPrefix for the type of shadow to which you want to refer, replace thingName and if applicable, shadowName, with their corresponding values, and then append that with the topic stub as shown in the following table. Remember that topics are case sensitive.

Topic	Client operations allowed	Description
`ShadowTopicPrefix`/delete	Publish/Subscribe	A device or an application publishes to this topic to delete a shadow. For more information, see /delete.
`ShadowTopicPrefix`/delete/accepted	Subscribe	The Device Shadow service sends messages to this topic when a shadow is deleted. For more information, see /delete/accepted.
`ShadowTopicPrefix`/delete/rejected	Subscribe	The Device Shadow service sends messages to this topic when a request to delete a shadow is rejected. For more information, see /delete/rejected.
`ShadowTopicPrefix`/get	Publish/Subscribe	An application or a thing publishes an empty message to this topic to get a shadow. For more information, see Device Shadow MQTT topics.
`ShadowTopicPrefix`/get/accepted	Subscribe	The Device Shadow service sends messages to this topic when a request for a shadow is made successfully. For more information, see /get/accepted.
`ShadowTopicPrefix`/get/rejected	Subscribe	The Device Shadow service sends messages to this topic when a request for a shadow is rejected. For more information, see /get/rejected.
`ShadowTopicPrefix`/update	Publish/Subscribe	A thing or application publishes to this topic to update a shadow. For more information, see /update.
`ShadowTopicPrefix`/update/accepted	Subscribe	The Device Shadow service sends messages to this topic when an update is successfully made to a shadow. For more information, see /update/accepted.
`ShadowTopicPrefix`/update/rejected	Subscribe	The Device Shadow service sends messages to this topic when an update to a shadow is rejected. For more information, see /update/rejected.
`ShadowTopicPrefix`/update/delta	Subscribe	The Device Shadow service sends messages to this topic when a difference is detected between the reported and desired sections of a shadow. For more information, see /update/delta.
`ShadowTopicPrefix`/update/documents	Subscribe	Amazon IoT publishes a state document to this topic whenever an update to the shadow is successfully performed. For more information, see /update/documents.

MQTT-based file delivery topics

Note

These messages support response buffers in Concise Binary Object Representation (CBOR) format and JavaScript Object Notation (JSON), depending on the payload-format of the topic.

`payload-format`	Response format data type
cbor	Concise Binary Object Representation (CBOR)
json	JavaScript Object Notation (JSON)

Topic	Client operations allowed	Description
$aws/things/`ThingName`/streams/`StreamId`/data/`payload-format`	Subscribe, Receive	Amazon MQTT-based file delivery publishes to this topic if the "GetStream" request from a device is accepted. The payload contains the stream data. For more information, see Using Amazon IoT MQTT-based file delivery in devices.
$aws/things/`ThingName`/streams/`StreamId`/get/`payload-format`	Publish	A device publishes to this topic to perform a "GetStream" request. For more information, see Using Amazon IoT MQTT-based file delivery in devices.
$aws/things/`ThingName`/streams/`StreamId`/description/`payload-format`	Subscribe, Receive	Amazon MQTT-based file delivery publishes to this topic if the "DescribeStream" request from a device is accepted. The payload contains the stream description. For more information, see Using Amazon IoT MQTT-based file delivery in devices.
$aws/things/`ThingName`/streams/`StreamId`/describe/`payload-format`	Publish	A device publishes to this topic to perform a "DescribeStream" request. For more information, see Using Amazon IoT MQTT-based file delivery in devices.
$aws/things/`ThingName`/streams/`StreamId`/rejected/`payload-format`	Subscribe, Receive	Amazon MQTT-based file delivery publishes to this topic if a "DescribeStream" or "GetStream" request from a device is rejected. For more information, see Using Amazon IoT MQTT-based file delivery in devices.

Reserved topic ARN

All reserved topic ARNs (Amazon Resource Names) have the following form:


arn:aws:iot:aws-region:AWS-account-ID:topic/Topic

For example, arn:aws:iot:us-west-2:123EXAMPLE456:topic/$aws/things/thingName/jobs/get/accepted is an ARN for the reserved topic $aws/things/thingName/jobs/get/accepted.

Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

MQTT message payload

Configurable endpoints