Partager via


azure-iot-common package

Classes

Message

L’objet Message est utilisé pour la télémétrie (appareil à cloud) et les commandes (cloud-à-appareil) de messagerie asynchrone entre l’appareil et le service IoT Hub. Il est indépendant du transport, ce qui signifie qu’il fonctionne de la même façon sur AMQP, MQTT et HTTP.

ArgumentError

Erreur levée lorsqu’un argument n’est pas valide.

ArgumentOutOfRangeError

Erreur levée lorsqu’un argument a une valeur hors de la plage admissible.

BadDeviceResponseError

Erreur levée lorsqu’un appareil envoie une mauvaise réponse à un appel de méthode d’appareil.

CloudToDeviceDetachedError

Erreur levée lorsque la fonctionnalité c2d a cessé de fonctionner au niveau du transport, ce qui oblige le client à réessayer de le démarrer.

DeviceAlreadyExistsError

Erreur levée lorsque l’ID d’appareil utilisé pour la création de l’appareil existe déjà dans le Registre des identités d’appareil.

DeviceMaximumQueueDepthExceededError

Erreur levée lorsque la file d’attente de messages d’un appareil est pleine.

DeviceMessageLockLostError

Erreur levée lors de l’échec du règlement d’un message, car le jeton de verrouillage associé au message est perdu.

DeviceMethodsDetachedError

Erreur levée lorsque la fonctionnalité méthodes de l’appareil a cessé de fonctionner au niveau du transport, ce qui oblige le client à réessayer de le démarrer.

DeviceNotFoundError

Erreur levée lorsqu’un appareil est introuvable dans le registre d’instances IoT Hub.

DeviceRegistrationFailedError

Erreur levée lors de l’échec d’une opération d’inscription DPS

DeviceTimeoutError

Erreur levée lorsque l’appareil ne traite pas l’appel de méthode dans le temps.

FormatError

Erreur levée lorsqu’une chaîne censée avoir une mise en forme spécifique n’est pas correctement mise en forme.

GatewayTimeoutError

Erreur levée lorsque l’instance IoT Hub ne traite pas l’appel de méthode de l’appareil dans le temps.

InternalServerError

Erreur levée lorsqu’une erreur de serveur interne s’est produite. Vous avez peut-être trouvé un bogue ?

InvalidEtagError

Erreur levée lorsque l’eTag spécifié est correctement mis en forme ou obsolète.

InvalidOperationError

Erreur levée lorsqu’une opération est tentée, mais n’est pas autorisée.

IotHubNotFoundError

Erreur levée lorsque le hub Azure IoT est introuvable.

IotHubQuotaExceededError

Erreur levée lors du dépassement du quota du hub Azure IoT. Les quotas sont réinitialisés périodiquement, cette opération devra attendre jusqu’à ce moment-là. Pour en savoir plus sur les quotas, consultez quotas Azure IoT Hub et

IoTHubSuspendedError

Erreur levée lorsque IoT Hub a été suspendu.

JobNotFoundError

Erreur levée lorsque le travail avec l’identificateur spécifié n’a pas été trouvé.

MessageTooLargeError

Erreur levée lorsque le message envoyé est trop grand : la taille maximale est de 256 Ko.

NotConnectedError

Erreur levée lorsque l’appareil est déconnecté et que l’opération ne peut pas être terminée.

NotImplementedError

Erreur levée lorsqu’une fonctionnalité n’est pas encore implémentée, mais que l’espace réservé est présent.

OperationCancelledError

Erreur levée lorsqu’une opération (locale ou distante) est annulée

PreconditionFailedError

Erreur levée lorsqu’une condition qui doit avoir été remplie pour exécuter une opération n’a pas été effectuée.

SecurityDeviceError

Erreur levée lorsqu’un périphérique/pilote de sécurité de bas niveau échoue.

ServiceUnavailableError

Erreur levée lorsque le service n’est pas disponible. L’opération doit être retentée.

ThrottlingError

Erreur levée lorsque IoT Hub est limité en raison d’une activité excessive. Pour en savoir plus sur les quotas, consultez quotas Azure IoT Hub et

TimeoutError

Erreur levée lorsqu’un délai d’attente se produit

TooManyDevicesError

Erreur levée lorsque le nombre maximal d’appareils sur un hub spécifique a été atteint.

TwinDetachedError

Erreur levée lorsque la fonctionnalité de jumeau a cessé de fonctionner au niveau du transport, ce qui oblige le client à réessayer de le démarrer.

TwinRequestError

Erreur générique levée lorsqu’une demande de jumeau échoue avec un code d’erreur inconnu.

UnauthorizedError

Erreur levée lorsque les paramètres de connexion sont incorrects et que le serveur a refusé la connexion.

Connected

Résultat retourné lorsqu’un transport est correctement connecté.

Disconnected

Résultat retourné lorsqu’un transport est correctement déconnecté.

MessageAbandoned

Résultat retourné lorsqu’un message a été abandonné avec succès.

MessageCompleted

Résultat retourné lorsqu’un message a été rejeté avec succès.

MessageEnqueued

Résultat retourné lorsqu’un message a été mis en file d’attente.

MessageRejected

Résultat retourné lorsqu’un message a été rejeté avec succès.

SharedAccessSignatureUpdated

Résultat retourné lorsqu’un jeton SAP a été correctement mis à jour.

TransportConfigured

Résultat retourné lorsqu’un transport est correctement configuré.

ConnectionString

Décrit les paramètres qui permettent à un appareil ou à une application cloud de se connecter à un hub Azure IoT.

ExponentialBackOffWithJitter

Implémente un backoff exponentiel avec une stratégie de nouvelle tentative de gigue. La fonction à calculer l’intervalle suivant est la suivante (x est la nouvelle tentative x) : F(x) = min(Cmin+ (2^(x-1)-1) * rand(C * (1 – Jd), C*(1-Ju)), Cmax)

NoRetry

Stratégie stub qui bloque toute nouvelle tentative de nouvelle tentative. Les opérations ne sont pas retentées.

RetryOperation

Implémente la logique nécessaire pour réessayer des opérations telles que la connexion, la réception de messages C2D, l’envoi de données de télémétrie, les mises à jour de jumeaux, etc.

SharedAccessSignature

Les jetons de signature d’accès partagé sont utilisés pour authentifier la connexion lors de l’utilisation de clés symétriques (par opposition aux certificats x509) pour sécuriser la connexion avec Azure IoT Hub.

Interfaces

AuthenticationProvider

Interface qui doit être implémentée par des objets utilisés pour fournir des informations d’identification aux transports utilisés par le client d’appareil pour s’authentifier auprès d’une instance Azure IoT Hub.

Receiver
RetryPolicy

Interface décrivant un objet de stratégie de nouvelle tentative. Les stratégies de nouvelle tentative sont composées de 2 éléments

  • Algorithme qui calcule la prochaine fois pour réessayer en fonction du nombre actuel ou des nouvelles tentatives.
  • Filtre d’erreur qui décide, en fonction du type d’erreur reçu, si une nouvelle tentative doit se produire ou non.

Ces 2 composants se cachent derrière 2 appels de méthode décrits dans cette interface.

TransportConfig

Structure de configuration utilisée par les objets transport et AuthenticationProvider pour stocker et échanger des informations d’identification.

X509

Objet utilisé pour stocker un certificat et une clé X509 pour les transports à utiliser.

Cela est transmis directement aux objets de bas niveau utilisés par Node.js pour connecter le socket TLS. https://nodejs.org/api/tls.html#tls_tls_connect_options_callback

Alias de type

BufferConvertible
ResultWithHttpResponse
Callback

Définit le type décrivant le rappel standard avec deux résultats : l’un est l’erreur, l’autre est la valeur du résultat.

DoubleValueCallback

Définit le type décrivant le rappel avec deux résultats.

ErrorCallback

Définit le type décrivant le rappel avec uniquement la valeur du résultat d’erreur.

HttpResponseCallback

Définit le type décrivant le rappel avec trois résultats : réponse, réponse HTTP brute et erreur.

NoErrorCallback

Définit le type décrivant le rappel avec une valeur de résultat non-erreur.

TripleValueCallback

Définit le type décrivant le rappel standard avec trois résultats : le premier est Error, les deux autres sont les valeurs de résultat.

Énumérations

AuthenticationType

Désignez le type d’authentification utilisé par un AuthenticationProvider.

Functions

anHourFromNow()

Retourne les secondes écoulées depuis le 1er janvier 1970 00:00:00 UTC jusqu’à une heure.

encodeUriComponentStrict(string)

Informations relatives à la fonction

anHourFromNow()

Retourne les secondes écoulées depuis le 1er janvier 1970 00:00:00 UTC jusqu’à une heure.

function anHourFromNow(): number

Retours

number

encodeUriComponentStrict(string)

function encodeUriComponentStrict(str: string): string

Paramètres

str

string

Retours

string