View a markdown version of this page

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 un signe dollar ($) sont réservées à 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/ assetModelId /properties/ assetId propertyId

S’abonner

AWS IoT SiteWise publie des notifications sur les propriétés des actifs sur 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 topics

Ces messages prennent en charge les buffers de réponse au format CBOR (Concise Binary JavaScript Object Representation) et au format JSON (Object Notation), selon le payload-format sujet. AWS IoT Device Defender les sujets ne prennent en charge que la publication MQTT.

payload-format Type de données du format de réponse
CBOR CBOR (Concise Binary Object Representation, représentation concise d'objets binaires)
json JavaScript Notation d'objet (JSON)

Pour plus d'informations, consultez la section Envoi de statistiques depuis des appareils.

Rubrique Opérations autorisées Description

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

Publication

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

$aws/things//thingNamedefender/metrics/payload-format/accepté

S’abonner

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

$aws/things//thingNamedefender/metrics/payload-format/rejeté

S’abonner

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

AWS IoT Core Rubriques sur la localisation des appareils

AWS IoT Core Device Location peut résoudre les données de mesure de votre appareil et fournir une estimation de la position de vos appareils IoT. Les données de mesure provenant de l'appareil peuvent inclure des adresses GNSS Wi-Fi, cellulaires et 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 de l'appareil en utilisant AWS IoT Core Rubriques MQTT relatives à la localisation des appareils.

Rubrique Opérations autorisées Description

$aws/device_location/customer_device_id/obtenir_estimation_position

Publication

Un appareil publie dans cette rubrique pour obtenir les données de mesure brutes numérisées à résoudre par AWS IoT Core Device Location.

$aws/device_location/customer_device_id/get_position_estimate/accepted

S’abonner

AWS IoT Core Device Location publie sur cette rubrique une fois que la localisation de l'appareil a été résolue avec succès.

$aws/device_location/customer_device_id/get_position_estimate/rejected

S’abonner

AWS IoT Core Device Location publie sur cette rubrique lorsqu'il n'est pas en mesure 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/ /annulé jobID

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/ /annulation_en_cours jobID

S’abonner

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

$ aws/events /job/ /terminé jobID

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/ /supprimé jobID

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/ /deletion_in_progress jobID

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/ /annulé jobID

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/ /supprimé jobID

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/ /a échoué jobID

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/ /rejeté jobID

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/ /supprimé jobID

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/ /réussi jobID

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/ /timed_out jobID

S’abonner

AWS IoT publie ce message lorsqu'un 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 client MQTT avec l'ID client spécifié se connecte AWS IoT. Pour de plus amples informations, veuillez consulter Connect/Disconnect événements.

$aws/events/presence/disconnected/clientId

S’abonner

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

$aws/events/subscriptions/subscribed/clientId

S’abonner

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

$aws/events/subscriptions/unsubscribed/clientId

S’abonner

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

$ aws/events /chose/ /créé thingName

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/ /mis thingName à jour

S’abonner

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

$ aws/events /thing/ /supprimé thingName

S’abonner

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

$ aws/events /ThingGroup/ /created thingGroupName

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/ /mise à jour thingGroupName

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/ /supprimé thingGroupName

S’abonner

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

$ aws/events /ThingType/ /created thingTypeName

S’abonner

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

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

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/ /supprimé thingTypeName

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/thingGroupthingGroupName/chose/ /ajouté thingName

S’abonner

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

$aws/events//thingGroupMembership/thingGroupthingGroupName/thing/ /supprimé thingName

S’abonner

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

$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/enfantThingGroup/childThingGroupName/ajouté

S’abonner

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

$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/supprimé

S’abonner

AWS IoT publie sur cette rubrique lorsqu'un 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 comme Réception dans ce tableau indiquent les sujets AWS IoT qui sont publiés directement auprès du client qui l'a demandé, que celui-ci soit abonné à la rubrique 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 buffers de réponse au format CBOR (Concise Binary JavaScript Object Representation) et au format JSON (Object Notation), selon le payload-format sujet.

payload-format Type de données du format de réponse
CBOR CBOR (Concise Binary Object Representation, représentation concise d'objets binaires)
json JavaScript Notation d'objet (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 /créer/ payload-format

Publication

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

$ aws/certificates /créer/ /accepté payload-format

S’abonner, recevoir

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

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

S’abonner, recevoir

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

$ aws/certificates /créer-depuis-csr/ payload-format

Publication

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

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

S’abonner, recevoir

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

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

S’abonner, recevoir

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

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

Publication

Publiez dans cette rubrique pour enregistrer un objet.

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

S’abonner, recevoir

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

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

S’abonner, recevoir

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

Rubriques de tâche

Note

Les opérations client notées comme Réception dans ce tableau indiquent les sujets AWS IoT qui sont publiés directement auprès du client qui l'a demandé, que celui-ci soit abonné à la rubrique 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 Opérations de l’API MQTT de l’appareil des tâches.

Rubrique Opérations autorisées du client Description

$aws/things/thingName/jobs/get

Publication

Les appareils publient un message dans cette rubrique pour envoyer une demande GetPendingJobExecutions. Pour de plus amples informations, veuillez consulter Opérations de l’API MQTT de l’appareil des tâches.

$aws/things/thingName/jobs/get/accepté

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 Opérations de l’API MQTT de l’appareil des tâches.

$aws/things/thingName/jobs/get/rejeté

S’abonner, Recevoir

Les appareils s'abonnent à cette rubrique lorsqu'une demande GetPendingJobExecutions est rejetée. Pour de plus amples informations, veuillez consulter Opérations de l’API MQTT de l’appareil des tâches.

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

Publication

Les appareils publient un message dans cette rubrique pour envoyer une demande StartNextPendingJobExecution. Pour de plus amples informations, veuillez consulter Opérations de l’API MQTT de l’appareil des tâches.

$aws/things/thingName/jobs/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 Opérations de l’API MQTT de l’appareil des tâches.

$aws/things/thingName/jobs/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 Opérations de l’API MQTT de l’appareil des tâches.

$aws/things/thingName/emplois/ /obtenir jobId

Publication

Les appareils publient un message dans cette rubrique pour envoyer une demande DescribeJobExecution. Pour de plus amples informations, veuillez consulter Opérations de l’API MQTT de l’appareil des tâches.

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

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 Opérations de l’API MQTT de l’appareil des tâches.

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

S’abonner, Recevoir

Les appareils s'abonnent à cette rubrique lorsqu'une demande DescribeJobExecution est rejetée. Pour de plus amples informations, veuillez consulter Opérations de l’API MQTT de l’appareil des tâches.

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

Publication

Les appareils publient un message dans cette rubrique pour envoyer une demande UpdateJobExecution. Pour de plus amples informations, veuillez consulter Opérations de l’API MQTT de l’appareil des tâches.

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

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 Opérations de l’API MQTT de l’appareil des tâches.

Remarque

Seul l'appareil qui publie sur $aws/things/thingName/jobs/ jobId /update reçoit des messages sur ce sujet.

$aws/things/thingName/emplois/jobId/update/rejected

S’abonner, recevoir

Les appareils s'abonnent à cette rubrique lorsqu'une demande UpdateJobExecution est rejetée. Pour de plus amples informations, veuillez consulter Opérations de l’API MQTT de l’appareil des tâches.

Remarque

Seul l'appareil qui publie sur $aws/things/thingName/jobs/ jobId /update reçoit des messages sur ce sujet.

$aws/things/thingName/jobs/notify

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 Opérations de l’API MQTT de l’appareil des tâches.

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

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 Opérations de l’API MQTT de l’appareil des tâches.

$ aws/events /job/ /terminé jobId

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/ /annulé jobId

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/ /supprimé jobId

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/ /annulation_en_cours jobId

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/ /deletion_in_progress jobId

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/ /réussi jobId

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/ /a échoué jobId

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/ /rejeté jobId

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/ /annulé jobId

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/ /timed_out jobId

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/ /supprimé jobId

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/ /supprimé jobId

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 comme Réception dans ce tableau indiquent les sujets AWS IoT qui sont publiés directement auprès du client qui l'a demandé, que celui-ci soit abonné à la rubrique 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//<devices><DeviceID>/exécutions/ <ExecutionId> /demande/ <PayloadFormat>

$aws/commands/<devices>/<DeviceID>/exécutions/ /demande <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 de l'StartCommandExecutionAPI. Dans ce cas, il <devices> peut s'agir d'objets IoT ou de clients MQTT, et il <DeviceID> peut s'agir du nom de l'objet IoT ou de l'ID client MQTT.

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

Publication

Les appareils utilisent l'API UpdateCommandExecution MQTT pour publier un message dans 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 de l'StartCommandExecutionAPI. Le message publié utilisera JSON ou CBOR comme. <PayloadFormat>

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

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

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/<devices>/<DeviceID>/exécutions/<ExecutionId>//response/rejected<PayloadFormat>

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

Publication

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

Rubriques de règle

Rubrique Opérations autorisées du client Description

$aws/rules/ruleName

Publication

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/thing-name/tunnels/notify

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/thingName/ombre Shadow non nommé (classique)
$aws/things/thingName/shadow/name/shadowName Shadow nommé

Pour créer une rubrique complète, sélectionnez le ShadowTopicPrefix type d'ombre auquel vous souhaitez faire référence, remplacez-la thingName et, le cas échéantshadowName, par les valeurs correspondantes, puis ajoutez-la au talon de 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

Publish/Subscribe

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

ShadowTopicPrefix/delete/accepted

S’abonner

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

ShadowTopicPrefix/delete/rejected

S’abonner

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

ShadowTopicPrefix/obtenir

Publish/Subscribe

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

ShadowTopicPrefix/get/accepted

S’abonner

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

ShadowTopicPrefix/get/rejected

S’abonner

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

ShadowTopicPrefix/mise à jour

Publish/Subscribe

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

ShadowTopicPrefix/update/accepted

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 plus d'informations, voir/update/accepted.

ShadowTopicPrefix/update/rejected

S’abonner

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

ShadowTopicPrefix/update/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 plus d'informations, voir/update/delta.

ShadowTopicPrefix/update/documents

S’abonner

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

MQTT-based sujets relatifs à la livraison de fichiers

Note

Les opérations client notées comme Réception dans ce tableau indiquent les sujets AWS IoT qui sont publiés directement auprès du client qui l'a demandé, que celui-ci soit abonné à la rubrique 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 buffers de réponse au format CBOR (Concise Binary JavaScript Object Representation) et au format JSON (Object Notation), selon le payload-format sujet.

payload-format Type de données du format de réponse
CBOR CBOR (Concise Binary Object Representation, représentation concise d'objets binaires)
json JavaScript Notation d'objet (JSON)
Rubrique Opérations autorisées du client Description

$aws/things/ThingName/streams/ StreamId /données/ payload-format

S’abonner, recevoir

AWS MQTT-based file delivery publie des publications sur 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 AWS IoT MQTT-based livraison de fichiers sur les appareils.

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

Publication

Un appareil publie dans cette rubrique pour effectuer une demande de type GetStream « ». Pour de plus amples informations, veuillez consulter Utilisation AWS IoT MQTT-based livraison de fichiers sur les appareils.

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

S’abonner, recevoir

AWS MQTT-based file delivery publie des publications sur 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 AWS IoT MQTT-based livraison de fichiers sur les appareils.

$aws/things/ThingName/streams/ StreamId /décrive/ payload-format

Publication

Un appareil publie dans cette rubrique pour effectuer une demande de type DescribeStream « ». Pour de plus amples informations, veuillez consulter Utilisation AWS IoT MQTT-based livraison de fichiers sur les appareils.

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

S’abonner, recevoir

AWS MQTT-based file delivery publie des publications sur cette rubrique si une demande DescribeStream « » ou GetStream « » provenant d'un appareil est rejetée. Pour de plus amples informations, veuillez consulter Utilisation AWS IoT MQTT-based livraison de fichiers sur les appareils.

ARN de sujets réservés

Tous les ARN de sujets réservés (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 un ARN pour le sujet réservé$aws/things/thingName/jobs/get/accepted.