Classes d’extension de l’API sans correspondance

Rversion finale: Australia

Mis à jour 12 mars 2026

5 minutes de lecture

L’application Modèles de classe CI CMDB ajoute ou met à jour des classes pour les API sans correspondance. Les points de terminaison d’API qui ne sont pas suffisamment structurés pour renseigner les classes API [cmdb_ci_api] et Composant d’API [cmdb_ci_api_component] renseignent plutôt la classe Point de terminaison d’API sans correspondance [cmdb_ci_unmatched_api_endpoint]. Les API sans correspondance sont généralement utilisées par des intégrations telles que les scanners de sécurité ou les outils d’observabilité.

Modèles de classe CI CMDB est une application qui ajoute des ServiceNow Store modèles de classe qui étendent la hiérarchie des CMDB classes. Les classes nouvelles ou mises à jour comprennent des descriptions de classe, des règles d’identification, des entrées d’identificateur et, le cas échéant, des relations dépendantes. Vous pouvez utiliser les classes ajoutées comme n’importe quelle autre CMDB classe. Les applications telles que peuvent Schémas de découverte et de mappage des services utiliser les extensions de classe pour renseigner les CI et découvrir des technologies et des logiciels.

Voir les notes de version complètes pour tout Modèles de classe CI CMDB.

Demander des applications dans l'App Store

Visitez le ServiceNow Store pour afficher toutes les applications disponibles et pour obtenir des informations sur la soumission de demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les ServiceNow Store notes de publication relatives à l'historique des versions.

API sans correspondance

Les points de terminaison d’API qui ne sont pas suffisamment structurés pour renseigner les classes API [cmdb_ci_api] et Composant d’API [cmdb_ci_api_component] renseignent plutôt la classe Point de terminaison d’API sans correspondance [cmdb_ci_unmatched_api_endpoint]. Les API sans correspondance sont généralement utilisées par des intégrations telles que les scanners de sécurité ou les outils d’observabilité.

Classes

Cette section répertorie les classes que l’application Modèles de classe CI CMDB ajoute ou met à jour.

Modèles de classe CI CMDB: la version 1.49.0 ajoute la classe suivante pour les points de terminaison d’API sans correspondance. Pour obtenir la liste des classes dans le , y compris les système de base classes que cette application peut étendre, reportez-vous à la section Descriptions des tables CMDB.


Classe	Extensions	Description
Point de terminaison de l'API sans correspondance [cmdb_ci_unmatched_api_endpoint]	Élément de configuration [cmdb_ci]	API avec des points de terminaison non structurés qui ne peuvent pas renseigner cmdb_ci_api ou cmdb_ci_api_component.

Attributs de classe

Modèles de classe CI CMDB: la version 1.49.0 ajoute les attributs suivants à la classe des points de terminaison d’API sans correspondance [cmdb_ci_unmatched_api_endpoint].

Tableau 1. Point de terminaison de l’API sans correspondance [cmdb_ci_unmatched_api_endpoint]
Attribut	Type de données	Description
Fonction de message REST	Chaîne	Types de protocoles back-end de l’API. Exemples : Lambda HTTP Application logique
Protocole	Chaîne	Protocole de communication. Exemple : HTTP, HTTPS.
URL	String (1024)	URL de la ressource appelée.
ID	String (1024)	Identificateur unique du système source.
Accessible sur Internet	Booléen	Valeur booléenne qui indique si le composant est accessible à partir de l’Internet public. Spécifiez 1 ou « vrai » si le composant est accessible.
Autorisation	Chaîne	Type de méthode d’autorisation ou d’authentification. Exemple : Élémentaire Clé OAuth Aucun
Types de données de la demande	String (255)	Liste des types de données dans la demande. Exemples : Cc E-mail Adresse
Types de données de réponse	String (255)	Liste des types de données dans la réponse. Exemples : Cc E-mail Adresse

Structures de relations clés

La classe de point de terminaison d’API sans correspondance [cmdb_ci_unmatched_api_endpoint] CMDB et la table non CMDB Point de terminaison d’API détecté [api_endpoint_discovered] sont conçues pour les scénarios dans lesquels des données d’API non structurées sont ingérées et doivent être traitées au-delà des options du Centre d’intégration-ETL.

Point de terminaison d’API détecté [api_endpoint_discovered] peut servir de table intermédiaire pour les données brutes pour les classes API [cmdb_ci_api] et Composant d’API [cmdb_ci_api_component]. Les données d’API qui ne proviennent pas d’une source de données bien structurée ou qui ne peuvent pas être soumises à des règles d’identification standard peuvent d’abord remplir la table Point de terminaison d’API détecté [api_endpoint_discovered]. Vous pouvez ensuite utiliser une intégration définie par le client pour promouvoir que les données correctement formées qui correspondent aux exigences de qualité et de condition de l’API [cmdb_ci_api] et du composant d’API [cmdb_ci_api_component] remplissent la table la plus appropriée.

Si les données ne peuvent pas être analysées correctement ou sont structurées de manière inattendue, vous pouvez utiliser une intégration définie par le client pour remplir la table Point de terminaison d’API sans correspondance [cmdb_ci_unmatched_api_endpoint].

Les données qui remplissent la table Point de terminaison d’API détecté [api_endpoint_discovered] sont purgées tous les 30 jours.

Tableau 2. Point de terminaison d’API détecté [api_endpoint_discovered]
Attribut	Type de données	Description
Nom	Chaîne (100)	Nom du point de terminaison de l’API.
Fonction de message REST	Chaîne	Méthodes API REST. Exemples : GET POST DELETE
URL	String (1024)	URL de la ressource appelée.
Type	Liste de choix	Type d’API. Vous pouvez spécifier : REST SOAP HTTP gRPC GraphQL Websocket
Autorisation	Chaîne	Type de méthode d’autorisation ou d’authentification. Exemple : Élémentaire Clé OAuth Aucun
Accessible sur Internet	Booléen	Valeur booléenne qui indique si le composant est accessible à partir de l’Internet public. Spécifiez 1 ou « vrai » si le composant est accessible.
Types de données de la demande	String (255)	Liste des types de données dans la demande. Exemples : Cc E-mail Adresse
Types de données de réponse	String (255)	Liste des types de données dans la réponse. Exemples : Cc E-mail Adresse
En-têtes	String (255)	Liste de noms d’en-têtes séparés par des virgules.
Élément de configuration	Référence	Référence à un CI correspondant CMDB (composant d’API ou point de terminaison d’API sans correspondance).

Non-tablesCMDB connexes

La classe d’extension API sans correspondance utilise la table non-CMDB Déploiement d’API [api_deployment] comme liste connexe :

Tableau 3. Déploiement d’API [api_deployment]
Attribut	Type de données	Description
Nom	Chaîne (100)	Nom du déploiement de l’API.
API	Référence	Référence à l’API déployée (cmdb_ci_api).
Point de terminaison de l'API sans correspondance	Référence	Référence au point de terminaison de l’API sans correspondance, si l’API ne correspond pas à une API existante (cmdb_ci_unmatched_api_endpoint).
Élément de configuration	Référence	Référence à l’élément de configuration. Ceci est généralement spécifié manuellement en tant que référence, si vous savez vers quel CI l’API est déployée.