Rubriques réservées - AWS IoT Core

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Rubriques réservées

Les rubriques commençant par le signe du dollar ($) sont réservées à l'usage de AWS IoT. Vous pouvez vous abonner à ces rubriques réservées et y publier lorsqu'elles le permettent. Toutefois, vous ne pouvez pas créer de nouvelles rubriques commençant par un signe dollar. Les opérations de publication ou d'abonnement à des rubriques réservées qui ne sont pas prises en charge peuvent entraîner la fin de la connexion.

Rubriques de modèle de ressource

Rubrique Opérations autorisées du client Description

$ aws/sitewise/asset -models/ /assets/ /properties/ assetModelId assetId propertyId

S’abonner

AWS IoT SiteWise publie des notifications relatives aux propriétés des actifs dans cette rubrique. Pour plus d'informations, consultez la section Interaction avec d'autres AWS services dans le guide de AWS IoT SiteWise l'utilisateur.

AWS IoT Device Defender sujets

Ces messages prennent en charge les tampons de réponse au format Concise Binary JavaScript Object Representation (JSON) et Object Notation (), selon le payload-format sujet. CBOR AWS IoT Device Defender seuls les sujets peuvent MQTT être publiés.

payload-format Type de données du format de réponse
CBOR Représentation concise d'objets binaires (CBOR)
json JavaScript Notation d'objets (JSON)

Pour plus d'informations, consultez la section Envoi de métriques depuis des appareils.

Rubrique Opérations autorisées Description

$aws/things/ /defender/metrics/ thingName payload-format

Publish

AWS IoT Device Defender les agents publient des métriques sur cette rubrique. Pour plus d'informations, consultez la section Envoi de métriques depuis des appareils.

$aws/things/ /defender/metrics/ /accepted thingName payload-format

S’abonner

AWS IoT publie sur cette rubrique après qu'un AWS IoT Device Defender agent a publié un message réussi dans thingName $aws/things/ /defender/metrics/. payload-format Pour plus d'informations, consultez la section Envoi de métriques depuis des appareils.

$aws/things/ /defender/metrics/ /rejeté thingName payload-format

S’abonner

AWS IoT publie sur cette rubrique après qu'un AWS IoT Device Defender agent a publié un message infructueux dans thingName $aws/things/ /defender/metrics/. payload-format Pour plus d'informations, consultez la section Envoi de métriques depuis des appareils.

AWS IoT Core Rubriques sur la localisation des appareils

AWS IoT Core La localisation de l'appareil peut résoudre les données de mesure de votre appareil et fournir une estimation de l'emplacement de vos appareils IoT. Les données de mesure de l'appareil peuvent inclure le Wi-FiGNSS, le réseau cellulaire et l'adresse IP. AWS IoT Core Device Location choisit ensuite le type de mesure offrant la meilleure précision et résout les informations de localisation de l'appareil. Pour plus d’informations, consultez AWS IoT Core Emplacement de l'appareil et Résolution de la localisation des appareils à l'aide des MQTT rubriques de localisation des AWS IoT Core appareils.

Rubrique Opérations autorisées Description

$aws/device_location/ /get_position_estimate customer_device_id

Publish

Un appareil publie dans cette rubrique pour obtenir les données de mesure brutes numérisées à résoudre en fonction de l'emplacement de AWS IoT Core l'appareil.

$aws/device_location/ /get_position_estimate/accepted customer_device_id

S’abonner

AWS IoT Core L'emplacement de l'appareil est publié dans cette rubrique une fois que la localisation de l'appareil a été correctement résolue.

$aws/device_location/ /get_position_estimate/rejeté customer_device_id

S’abonner

AWS IoT Core Device Location publie dans cette rubrique lorsqu'il n'est pas possible de résoudre correctement la localisation de l'appareil en raison d'erreurs 4xx.

Rubriques d'événement

Les messages d'événements sont publiés lorsque certains événements se produisent. Par exemple, le registre génère des événements quand des objets sont ajoutés, mis à jour ou supprimés. Le tableau présente les différents AWS IoT événements et les sujets qui leur sont réservés.

Rubrique Opérations autorisées du client Description

$aws/events/certificates/registered/caCertificateId

S’abonner

AWS IoT publie ce message lors de l'enregistrement AWS IoT automatique d'un certificat et lorsqu'un client présente un certificat avec le PENDING_ACTIVATION statut. Pour de plus amples informations, veuillez consulter Configuration de la première connexion par un client pour l'enregistrement automatique.

$aws/events/job/jobID/annulé

S’abonner

AWS IoT publie ce message lorsqu'une tâche est annulée. Pour de plus amples informations, veuillez consulter Événements Jobs.
$aws/events/job/jobID/annulation_en cours

S’abonner

AWS IoT publie ce message lorsqu'une annulation d'offre d'emploi est en cours. Pour de plus amples informations, veuillez consulter Événements Jobs.

$aws/events/job/jobID/terminé

S’abonner

AWS IoT publie ce message lorsqu'une tâche est terminée. Pour de plus amples informations, veuillez consulter Événements Jobs.
$aws/events/job/jobID/supprimé

S’abonner

AWS IoT publie ce message lorsqu'une tâche est supprimée. Pour de plus amples informations, veuillez consulter Événements Jobs.
$aws/events/job/jobID/deletion_in_en cours

S’abonner

AWS IoT publie ce message lorsqu'une tâche est en cours de suppression. Pour de plus amples informations, veuillez consulter Événements Jobs.
$aws/events/jobExecution/jobID/annulé

S’abonner

AWS IoT publie ce message lorsqu'une exécution de tâche est annulée. Pour de plus amples informations, veuillez consulter Événements Jobs.
$aws/events/jobExecution/jobID/supprimé

S’abonner

AWS IoT publie ce message lorsqu'une exécution de tâche est supprimée. Pour de plus amples informations, veuillez consulter Événements Jobs.
$aws/events/jobExecution/jobID/échec

S’abonner

AWS IoT publie ce message en cas d'échec de l'exécution d'une tâche. Pour de plus amples informations, veuillez consulter Événements Jobs.
$aws/events/jobExecution/jobID/rejeté

S’abonner

AWS IoT publie ce message lorsqu'une exécution de tâche a été rejetée. Pour de plus amples informations, veuillez consulter Événements Jobs.
$aws/events/jobExecution/jobID/supprimé

S’abonner

AWS IoT publie ce message lorsqu'une exécution de tâche a été supprimée. Pour de plus amples informations, veuillez consulter Événements Jobs.
$aws/events/jobExecution/jobID/réussi

S’abonner

AWS IoT publie ce message lorsqu'une tâche a été exécutée avec succès. Pour de plus amples informations, veuillez consulter Événements Jobs.
$aws/events/jobExecution/jobID/timed_out

S’abonner

AWS IoT publie ce message lorsque le délai d'exécution d'une tâche a expiré. Pour de plus amples informations, veuillez consulter Événements Jobs.

$aws/events/presence/connected/clientId

S’abonner

AWS IoT publie sur cette rubrique lorsqu'un MQTT client avec l'ID client spécifié se connecte à AWS IoT. Pour de plus amples informations, veuillez consulter Événements de connexion/déconnexion.

$aws/events/presence/disconnected/clientId

S’abonner

AWS IoT publie sur cette rubrique lorsqu'un MQTT client avec l'ID client spécifié se déconnecte de AWS IoT. Pour de plus amples informations, veuillez consulter Événements de connexion/déconnexion.

$aws/events/subscriptions/subscribed/clientId

S’abonner

AWS IoT publie sur cette rubrique lorsqu'un MQTT client avec l'ID client spécifié s'abonne à une MQTT rubrique. Pour de plus amples informations, veuillez consulter Événements d'abonnement/désabonnement.

$aws/events/subscriptions/unsubscribed/clientId

S’abonner

AWS IoT publie sur cette rubrique lorsqu'un MQTT client possédant l'ID client spécifié se désabonne d'une MQTT rubrique. Pour de plus amples informations, veuillez consulter Événements d'abonnement/désabonnement.

$aws/events/thing/thingName/créé

S’abonner

AWS IoT publie sur cette rubrique lorsque l'thingNameobjet est créé. Pour de plus amples informations, veuillez consulter Événements de registre.

$aws/events/thing/thingName/mis à jour

S’abonner

AWS IoT publie sur cette rubrique lorsque l'thingNameobjet est mis à jour. Pour de plus amples informations, veuillez consulter Événements de registre.

$aws/events/thing/thingName/supprimé

S’abonner

AWS IoT publie sur cette rubrique lorsque l'thingNameobjet est supprimé. Pour de plus amples informations, veuillez consulter Événements de registre.

$aws/events/thingGroup/thingGroupName/créé

S’abonner

AWS IoT publie sur cette rubrique lors de la création d'un groupe thingGroupName d'objets. Pour de plus amples informations, veuillez consulter Événements de registre.

$aws/events/thingGroup/thingGroupName/mis à jour

S’abonner

AWS IoT publie sur cette rubrique lorsque le groupe d'objets thingGroupName est mis à jour. Pour de plus amples informations, veuillez consulter Événements de registre.

$aws/events/thingGroup/thingGroupName/supprimé

S’abonner

AWS IoT publie sur cette rubrique lorsque le groupe d'objets thingGroupName est supprimé. Pour de plus amples informations, veuillez consulter Événements de registre.

$aws/events/thingType/thingTypeName/créé

S’abonner

AWS IoT publie sur cette rubrique lorsque le type d'thingTypeNameobjet est créé. Pour de plus amples informations, veuillez consulter Événements de registre.

$aws/events/thingType/thingTypeName/mis à jour

S’abonner

AWS IoT publie dans cette rubrique lorsque le type d'thingTypeNameobjet est mis à jour. Pour de plus amples informations, veuillez consulter Événements de registre.

$aws/events/thingType/thingTypeName/supprimé

S’abonner

AWS IoT publie dans cette rubrique lorsque le type d'thingTypeNameobjet est supprimé. Pour de plus amples informations, veuillez consulter Événements de registre.

$aws/events/thingTypeAssociation/thing/thingName/thingTypeName

S’abonner

AWS IoT publie dans cette rubrique lorsqu'un objet thingName est associé ou dissocié d'un type thingTypeName d'objet. Pour de plus amples informations, veuillez consulter Événements de registre.

$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/ /ajouté thingName

S’abonner

AWS IoT publie dans cette rubrique lorsqu'un objet thingName est ajouté à un groupe d'objetsthingGroupName. Pour de plus amples informations, veuillez consulter Événements de registre.

$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/ /supprimé thingName

S’abonner

AWS IoT publie dans cette rubrique lorsqu'un objet thingName est retiré du groupe d'objetsthingGroupName. Pour de plus amples informations, veuillez consulter Événements de registre.

$aws/events/thingGroupHierarchy/thingGroup//parentThingGroupNamechildThingGroup/childThingGroupName/ajouté

S’abonner

AWS IoT publie sur cette rubrique lorsqu'un groupe d'objets childThingGroupName est ajouté à un groupe d'objetsparentThingGroupName. Pour de plus amples informations, veuillez consulter Événements de registre.

$aws/events/thingGroupHierarchy/thingGroup//parentThingGroupNamechildThingGroup/childThingGroupName/supprimé

S’abonner

AWS IoT publie sur cette rubrique lorsque le groupe d'objets childThingGroupName est supprimé du groupe d'objetsparentThingGroupName. Pour de plus amples informations, veuillez consulter Événements de registre.

Rubriques d’approvisionnement de la flotte

Note

Les opérations client notées « Recevoir » dans ce tableau indiquent les sujets AWS IoT qui sont publiés directement auprès du client qui les a demandés, que le client soit abonné au sujet ou non. Les clients doivent s'attendre à recevoir ces messages de réponse même s'ils ne s'y sont pas abonnés. Ces messages de réponse ne passent pas par le courtier de messages et ne peuvent pas être souscrits par d'autres clients ou règles.

Ces messages prennent en charge les tampons de réponse au format Concise Binary JavaScript Object Representation (JSON) et Object Notation (), selon le payload-format sujet. CBOR

payload-format Type de données du format de réponse
CBOR Représentation concise d'objets binaires (CBOR)
json JavaScript Notation d'objets (JSON)

Pour de plus amples informations, veuillez consulter API MQTT de mise en service des appareils.

Rubrique Opérations autorisées du client Description

$aws/certificates/create/payload-format

Publish

Publiez dans cette rubrique pour créer un certificat à partir d'une demande de signature de certificat (CSR).

$aws/certificates/create/payload-format/accepté

S’abonner, recevoir

AWS IoT publie sur cette rubrique après un appel réussi à $aws/certificates/create/payload-format.

$aws/certificates/create/payload-format/rejeté

S’abonner, recevoir

AWS IoT publie sur cette rubrique après un appel infructueux à $aws/certificates/create/payload-format.

$ aws/certificates/create -from-csr/ payload-format

Publish

Publie dans cette rubrique pour créer un certificat à partir d'unCSR.

$ aws/certificates/create payload-format -from-csr/ /accepté

S’abonner, recevoir

AWS IoT publie dans cette rubrique un appel réussi à $ aws/certificates/create payload-format -from-csr/.

$ aws/certificates/create payload-format -from-csr/ /rejeté

S’abonner, recevoir

AWS IoT publie dans cette rubrique un appel infructueux à $ aws/certificates/create payload-format -from-csr/.

$aws/modèles de provisionnement/ /provision/ templateName payload-format

Publish

Publiez dans cette rubrique pour enregistrer un objet.

$aws/provisioning-templates/ /provision/ /accepted templateName payload-format

S’abonner, recevoir

AWS IoT publie sur cette rubrique après un appel réussi à $aws/provisioning-templates/ /provision/templateName. payload-format

$aws/provisioning-templates/ /provision/ /rejeté templateName payload-format

S’abonner, recevoir

AWS IoT publie sur cette rubrique après un appel infructueux à $aws/provisioning-templates/ /provision/templateName. payload-format

Rubriques de tâche

Note

Les opérations client notées « Recevoir » dans ce tableau indiquent les sujets AWS IoT qui sont publiés directement auprès du client qui les a demandés, que le client soit abonné au sujet ou non. Les clients doivent s'attendre à recevoir ces messages de réponse même s'ils ne s'y sont pas abonnés.

Ces messages de réponse ne passent pas par le courtier de messages et ne peuvent pas être souscrits par d'autres clients ou règles. Pour vous abonner aux messages relatifs aux activités professionnelles, utilisez les notify-next rubriques notify et.

Lorsque vous vous abonnez aux rubriques relatives aux tâches et aux jobExecution événements de votre solution de surveillance de flotte, vous devez d'abord activer les événements relatifs aux tâches et à l'exécution des tâches pour recevoir les événements du côté cloud.

Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

Rubrique Opérations autorisées du client Description

$aws/things/ /jobs/get thingName

Publish

Les appareils publient un message dans cette rubrique pour envoyer une demande GetPendingJobExecutions. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

$aws/choses//thingNamejobs/get/accepted

S’abonner, recevoir

Les périphériques s'abonnent à cette rubrique pour recevoir des réponses positives à une demande GetPendingJobExecutions. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

$aws/choses//thingNamejobs/get/rejected

S’abonner, Recevoir

Les appareils s'abonnent à cette rubrique lorsqu'une demande GetPendingJobExecutions est rejetée. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

$aws/things/ /jobs/start-next thingName

Publish

Les appareils publient un message dans cette rubrique pour envoyer une demande StartNextPendingJobExecution. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

$aws/choses//thingNamejobs/start-next/accepted

S’abonner, recevoir

Les appareils s'abonnent à cette rubrique pour recevoir des réponses positives à une demande StartNextPendingJobExecution. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

$aws/choses//thingNamejobs/start-next/rejected

S’abonner, Recevoir

Les appareils s'abonnent à cette rubrique lorsqu'une demande StartNextPendingJobExecution est rejetée. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

$aws/things/ /jobs/ /get thingName jobId

Publish

Les appareils publient un message dans cette rubrique pour envoyer une demande DescribeJobExecution. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

$aws/things/ /jobs/ /get/accepted thingName jobId

S’abonner, recevoir

Les appareils s'abonnent à cette rubrique pour recevoir des réponses positives à une demande DescribeJobExecution. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

$aws/things/ /jobs/ /get/rejected thingName jobId

S’abonner, Recevoir

Les appareils s'abonnent à cette rubrique lorsqu'une demande DescribeJobExecution est rejetée. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

$aws/things/ /jobs/ /update thingName jobId

Publish

Les appareils publient un message dans cette rubrique pour envoyer une demande UpdateJobExecution. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

$aws/things/ /jobs/ /update/accepted thingName jobId

S’abonner, recevoir

Les appareils s'abonnent à cette rubrique pour recevoir des réponses positives à une demande UpdateJobExecution. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

Remarque

Seul le périphérique qui publie sur $aws/things/ thingName /jobs/ jobId /update reçoit des messages à ce sujet.

$aws/things/ /jobs/ /update/rejeté thingName jobId

S’abonner, recevoir

Les appareils s'abonnent à cette rubrique lorsqu'une demande UpdateJobExecution est rejetée. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

Remarque

Seul le périphérique qui publie sur $aws/things/ thingName /jobs/ jobId /update reçoit des messages à ce sujet.

$aws/things/ /jobs/notify thingName

S’abonner, recevoir

Les appareils s'abonnent à cette rubrique pour recevoir des notifications lorsque l'exécution d’une tâche est ajoutée ou supprimée de la liste des exécutions en attente pour un objet. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

$aws/things/ /jobs/notify-next thingName

S’abonner, recevoir

Les appareils s'abonnent à cette rubrique pour recevoir des notifications lorsque la prochaine tâche en attente d’exécution pour l’objet est modifiée. Pour de plus amples informations, veuillez consulter MQTTAPIOpérations sur les appareils Jobs.

$aws/events/job/jobId/terminé

S’abonner

Le service Jobs publie un événement sur cette rubrique lorsqu'une tâche est terminée. Pour de plus amples informations, veuillez consulter Événements Jobs.

$aws/events/job/jobId/annulé

S’abonner

Le service Jobs publie un événement sur cette rubrique lorsqu'une tâche est annulée. Pour de plus amples informations, veuillez consulter Événements Jobs.

$aws/events/job/jobId/supprimé

S’abonner

Le service Jobs publie un événement sur cette rubrique lorsqu'une tâche est supprimée. Pour de plus amples informations, veuillez consulter Événements Jobs.

$aws/events/job/jobId/annulation_en cours

S’abonner

Le service Jobs publie un événement sur cette rubrique lorsque l'annulation d'une tâche commence. Pour de plus amples informations, veuillez consulter Événements Jobs.

$aws/events/job/jobId/deletion_in_en cours

S’abonner

Le service Jobs publie un événement sur cette rubrique lorsque la suppression d'une tâche commence. Pour de plus amples informations, veuillez consulter Événements Jobs.

$aws/events/jobExecution/jobId/réussi

S’abonner

Le service Jobs publie un événement sur cette rubrique lorsque l'exécution d'une tâche est réussie. Pour de plus amples informations, veuillez consulter Événements Jobs.

$aws/events/jobExecution/jobId/échec

S’abonner

Le service Jobs publie un événement sur cette rubrique lorsque l'exécution d'une tâche échoue. Pour de plus amples informations, veuillez consulter Événements Jobs.

$aws/events/jobExecution/jobId/rejeté

S’abonner

Le service Jobs publie un événement sur cette rubrique lorsque l'exécution d'une tâche est rejetée. Pour de plus amples informations, veuillez consulter Événements Jobs.

$aws/events/jobExecution/jobId/annulé

S’abonner

Le service Jobs publie un événement sur cette rubrique lorsque l'exécution d'une tâche est annulée. Pour de plus amples informations, veuillez consulter Événements Jobs.

$aws/events/jobExecution/jobId/timed_out

S’abonner

Le service Jobs publie un événement sur cette rubrique lorsque l'exécution d'une tâche arrive à expiration. Pour de plus amples informations, veuillez consulter Événements Jobs.

$aws/events/jobExecution/jobId/supprimé

S’abonner

Le service Jobs publie un événement sur cette rubrique lorsque l'exécution d'une tâche est retirée. Pour de plus amples informations, veuillez consulter Événements Jobs.

$aws/events/jobExecution/jobId/supprimé

S’abonner

Le service Jobs publie un événement sur cette rubrique lorsque l'exécution d'une tâche est supprimée. Pour de plus amples informations, veuillez consulter Événements Jobs.

Rubriques relatives aux commandes

Note

Les opérations client notées « Recevoir » dans ce tableau indiquent les sujets AWS IoT qui sont publiés directement auprès du client qui les a demandés, que le client soit abonné au sujet ou non. Les clients doivent s'attendre à recevoir ces messages de réponse même s'ils ne s'y sont pas abonnés.

Ces messages de réponse ne passent pas par le courtier de messages et ne peuvent pas être souscrits par d'autres clients ou règles.

Rubrique Opérations autorisées du client Description

$aws/commands///exécutions/ /requête/ <devices> <DeviceID> <ExecutionId> <PayloadFormat>

$aws/commands///executions/ /request <devices> <DeviceID> <ExecutionId>

S’abonner, recevoir

Les appareils reçoivent un message à ce sujet lorsqu'une demande est faite pour démarrer l'exécution d'une commande depuis la console ou à l'aide du StartCommandExecutionAPI. Dans ce cas, il <devices> peut s'agir d'objets IoT ou de MQTT clients, et il <DeviceID> peut s'agir du nom de l'objet IoT ou de l'identifiant du MQTT client.

$aws/commands///exécutions/ /response/ <devices> <DeviceID> <ExecutionId> <PayloadFormat>

Publish

Les appareils utilisent le UpdateCommandExecution MQTT API pour publier un message sur cette rubrique concernant l'exécution de la commande. Le message est publié en réponse à la demande de lancement d'une exécution de commande depuis la console ou à l'aide du StartCommandExecutionAPI. Le message publié utilisera JSON ou CBOR en tant que<PayloadFormat>.

$aws/commands///executions/ /response/ <devices> /accepted <DeviceID> <ExecutionId> <PayloadFormat>

$aws/commands///executions/ /response/acceptée <devices> <DeviceID> <ExecutionId>

S’abonner, recevoir

Si le service cloud a traité avec succès le résultat de l'exécution de la commande, AWS IoT Device Management publie une réponse à la rubrique /accepté.

$aws/commands///executions/ /response/ <devices> /rejeté <DeviceID> <ExecutionId> <PayloadFormat>

$aws/commands///executions/ /response/rejeté <devices> <DeviceID> <ExecutionId>

Publish

Si le service cloud n'a pas réussi à traiter le résultat de l'exécution de la commande, AWS IoT Device Management publie une réponse à la rubrique /rejected.

Rubriques de règle

Rubrique Opérations autorisées du client Description

$aws/règles/ ruleName

Publish

Un appareil ou une application publie dans cette rubrique pour déclencher des règles directement. Pour de plus amples informations, veuillez consulter Réduction des coûts de messagerie avec Basic Ingest.

Rubriques liées au tunneling sécurisé

Rubrique Opérations autorisées du client Description

$aws/things/ /tunnels/notify thing-name

S’abonner

AWS IoT publie ce message pour qu'un agent IoT démarre un proxy local sur l'appareil distant. Pour de plus amples informations, veuillez consulter Extrait de l'agent IoT.

Rubriques de shadow

Les rubriques de cette section sont utilisées par les shadows nommés et non nommés. Les rubriques utilisées par chacun d'eux ne diffèrent que par le préfixe de rubrique. Ce tableau indique le préfixe de rubrique utilisé par chaque type de shadow.

Valeur ShadowTopicPrefix Type de shadow
$aws/things/ /shadow thingName Shadow non nommé (classique)
$aws/things/ /shadow/nom/ thingName shadowName Shadow nommé

Pour créer un sujet complet, sélectionnez le ShadowTopicPrefix type d'ombre auquel vous souhaitez faire référence, remplacez-le thingName et, le cas échéantshadowName, par les valeurs correspondantes, puis ajoutez-le avec le stub du sujet, comme indiqué dans le tableau suivant. N'oubliez pas que les rubriques sont sensibles à la casse.

Rubrique Opérations autorisées du client Description

ShadowTopicPrefix/supprimer

Publier/s'abonner

Un appareil ou une application publie dans cette rubrique pour supprimer un shadow. Pour de plus amples informations, veuillez consulter /delete.

ShadowTopicPrefix/supprimer/accepté

S’abonner

Le service Device Shadow envoie des messages à cette rubrique lorsqu'un shadow est supprimé. Pour de plus amples informations, veuillez consulter /delete/accepted.

ShadowTopicPrefix/supprimer/rejeté

S’abonner

Le service Device Shadow envoie des messages à cette rubrique lorsqu'une demande de suppression d'un shadow est rejetée. Pour de plus amples informations, veuillez consulter /delete/rejected.

ShadowTopicPrefix/obtenir

Publier/s'abonner

Une application ou un objet publie un message vide dans cette rubrique pour obtenir un shadow. Pour de plus amples informations, veuillez consulter MQTTSujets relatifs à Device Shadow.

ShadowTopicPrefix/obtenir/accepter

S’abonner

Le service Device Shadow envoie des messages à cette rubrique lorsqu'une demande de shadow est effectuée avec succès. Pour de plus amples informations, veuillez consulter /get/accepted.

ShadowTopicPrefix/obtenir/rejeté

S’abonner

Le service Device Shadow envoie des messages à cette rubrique lorsqu'une demande de shadow est rejetée. Pour de plus amples informations, veuillez consulter /get/rejected.

ShadowTopicPrefix/mise à jour

Publier/s'abonner

Un objet ou une application publie dans cette rubrique pour mettre à jour un shadow. Pour de plus amples informations, veuillez consulter /update.

ShadowTopicPrefix/mise à jour/accepté

S’abonner

Le service Device Shadow envoie des messages à cette rubrique lorsqu’une mise à jour aété effectuée avec succès dans un shadow. Pour de plus amples informations, veuillez consulter /update/accepted.

ShadowTopicPrefix/mise à jour/rejeté

S’abonner

Le service Device Shadow envoie des messages à cette rubrique lorsqu'une mise à jour d'un shadow est rejetée. Pour de plus amples informations, veuillez consulter /update/rejected.

ShadowTopicPrefix/mise à jour/delta

S’abonner

Le service Device Shadow envoie des messages à cette rubrique lorsqu'un écart est constaté entre les sections déclarées et les sections souhaitées d'un shadow. Pour de plus amples informations, veuillez consulter /update/delta.

ShadowTopicPrefix/mise à jour/documents

S’abonner

AWS IoT publie un document d'état sur cette rubrique chaque fois qu'une mise à jour du shadow est effectuée avec succès. Pour de plus amples informations, veuillez consulter /update/documents.

MQTTrubriques de livraison de fichiers basées sur la base

Note

Les opérations client notées « Recevoir » dans ce tableau indiquent les sujets AWS IoT qui sont publiés directement auprès du client qui les a demandés, que le client soit abonné au sujet ou non. Les clients doivent s'attendre à recevoir ces messages de réponse même s'ils ne s'y sont pas abonnés. Ces messages de réponse ne passent pas par le courtier de messages et ne peuvent pas être souscrits par d'autres clients ou règles.

Ces messages prennent en charge les tampons de réponse au format Concise Binary JavaScript Object Representation (JSON) et Object Notation (), selon le payload-format sujet. CBOR

payload-format Type de données du format de réponse
CBOR Représentation concise d'objets binaires (CBOR)
json JavaScript Notation d'objets (JSON)
Rubrique Opérations autorisées du client Description

$aws/things/ /streams/ /data/ ThingName StreamId payload-format

S’abonner, recevoir

AWS MQTTla livraison de fichiers basée sur la diffusion est publiée dans cette rubrique si la demande GetStream « » provenant d'un appareil est acceptée. La charge utile contient les données du flux. Pour de plus amples informations, veuillez consulter Utilisation de AWS IoT MQTT la livraison de fichiers basée sur les appareils.

$aws/things/ /streams/ /get/ ThingName StreamId payload-format

Publish

Un appareil publie sur cette rubrique pour exécuter une demande GetStream « ». Pour de plus amples informations, veuillez consulter Utilisation de AWS IoT MQTT la livraison de fichiers basée sur les appareils.

$aws/things/ /streams/ /description/ ThingName StreamId payload-format

S’abonner, recevoir

AWS MQTTla livraison de fichiers basée sur la diffusion est publiée dans cette rubrique si la demande DescribeStream « » provenant d'un appareil est acceptée. La charge utile contient la description du flux. Pour de plus amples informations, veuillez consulter Utilisation de AWS IoT MQTT la livraison de fichiers basée sur les appareils.

$aws/things/ /streams/ /describe/ ThingName StreamId payload-format

Publish

Un appareil publie sur cette rubrique pour exécuter une demande DescribeStream « ». Pour de plus amples informations, veuillez consulter Utilisation de AWS IoT MQTT la livraison de fichiers basée sur les appareils.

$aws/things/ /streams/ /rejeté/ ThingName StreamId payload-format

S’abonner, recevoir

AWS MQTTla diffusion de fichiers basée sur cette rubrique est publiée dans cette rubrique si une demande « GetStream » ou « » provenant d'un appareil est rejetée. DescribeStream Pour de plus amples informations, veuillez consulter Utilisation de AWS IoT MQTT la livraison de fichiers basée sur les appareils.

Sujet réservé ARN

Toutes les rubriques réservées ARNs (Amazon Resource Names) ont la forme suivante :

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

Par exemple, arn:aws:iot:us-west-2:123EXAMPLE456:topic/$aws/things/thingName/jobs/get/accepted est ARN destiné au sujet réservé$aws/things/thingName/jobs/get/accepted.