Clés de corrélation
Les clés de corrélation sont des chaînes de caractères qui identifient de façon unique une ressource dans un projet. Chaque ressource a une clé de corrélation. Si la ressource est supprimée puis recréée dans le même projet, sa clé de corrélation est identique. Une ressource peut donc être identifiée par sa valeur correlationKey.
Les abonnements sur événement utilisent les clés de corrélation pour savoir si leur délai de réactivation (cooldown) pour une ressource est expiré et si l'abonnement est prêt à se déclencher de nouveau. Ils utilisent aussi la clé de corrélation de la ressource pour trouver la ressource et vérifier si elle est bloquée.
Exemples de clés de corrélation pour un projet dont l'identifiant est 65f123fc861a16c1a9698357 :
| Ressource | Exemple de clé de corrélation |
|---|---|
| Domaine | project:65f123fc861a16c1a9698357;domain:example.com |
| Hôte | project:65f123fc861a16c1a9698357;host:127.0.0.1 |
| Port | project:65f123fc861a16c1a9698357;host:127.0.0.1;port:22;protocol:tcp |
| Site web | project:65f123fc861a16c1a9698357;host:206.189.173.197;port:80;protocol:tcp;domain:a1b2.ca;path:/ |
Une clé de corrélation existe aussi pour d'autres concepts qui ne sont pas des ressources à proprement parler.
Le premier concept est le projet (project). Une clé de corrélation peut être créée pour un projet; elle sert à marquer les déclenchements des abonnements cron. Une clé de corrélation de projet contient seulement la partie projet des autres clés de corrélation.
Le deuxième concept est la plage IP (IP ranges). Les plages IP sont stockées dans le projet lui-même et représentent un sous-réseau IPv4. Une clé de corrélation de plage IP a deux parties principales : l'adresse IP initiale, sous host, et le masque, une valeur comprise entre 0 et 32 inclusivement.
| Entité | Exemple de clé de corrélation |
|---|---|
| Projet | project:65f123fc861a16c1a9698357 |
| Plage IP | project:65f123fc861a16c1a9698357;host:127.0.0.1;mask:32 |