Amazon Détection de passerelle API avec modèles

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture

    • Les ServiceNow Découverte applications et Mappage des services utilisent le modèle Amazon AWS API Gateway pour rechercher Amazon des passerelles API et des connexions à d’autres entités. La détection de certaines de ces ressources peut nécessiter une mise à jour vers la dernière version de l’application Schémas de découverte et de mappage des services à partir du ServiceNow Store.

    Schémas de découverte et de mappage des services À partir de la version 1.29.0, le modèle de données de modèle Amazon AWS API Gateway a changé.

    Figure 1. Nouveau modèle de données de modèle Amazon AWS API Gateway
    Nouvelles relations du modèle de passerelles Amazon AWS API Gateway

    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.

    Prérequis

    Vérifiez les AWS prérequis
    Pour plus d’informations, reportez-vous à la section Conditions préalables dans AWS Découverte à l’aide de schémas.
    Mettre hors service les CI de modèles de données hérités pour éviter les doublons
    Pour éviter les CI en double, activez une tâche planifiée pour marquer les CI de modèle de données hérités comme mis hors service. Pour plus d'informations, consultez Mettre hors service les CI de modèles de données de passerelle API hérités AWS.

    Données collectées par Découverte lors d'une détection horizontale

    Découverte renseigne les données lors de l’exécution CMDB du modèle Amazon AWS API Gateway.

    Tableau 1. Passerelle AWS API [cmdb_ci_aws_api_gateway]
    Champ Description
    Nom [name] Concaténation de « aws-gateway- » + ID de compte + région.

    Par exemple : aws-gateway-0000000000000-us-east-1.
    ID [ID] Concaténation de « aws-gateway- » + ID de compte + région.

    Par exemple : aws-gateway-0000000000000-us-east-1.
    État de l'installation [install_status] État d’installation de la AWS passerelle. La valeur par défaut est installée.
    État opérationnel [operational_status] Statut opérationnel de la AWS passerelle. La valeur par défaut est Opérationnel.
    Tableau 2. API gérée [cmdb_ci_managed_api]
    Champ Description
    ID [ID] Concaténation de « https:// » + ID d’API + « .execute-api. » + région + « .amazonaws.com ».

    Par exemple : https://a1b2c3d4e5.execute-api.us-east-1.amazonaws.com.
    Nom [name] Nom de l’API.
    Description [short_description] Description de l’API.
    État de l'installation [install_status] État d’installation de l’API. La valeur par défaut est installée.
    État opérationnel [operational_status] Statut opérationnel de l’API. La valeur par défaut est Opérationnel.
    Type [type] Type d’API : REST.
    Version [version] Version de l’API.
    Nom de domaine complet [fqdn] Concaténation de l’ID API + « .execute-api. » + région + « .amazonaws.com ».

    Par exemple : a1b2c3d4e5.execute-api.us-east-1.amazonaws.com.
    Tableau 3. Nom DNS [cmdb_ci_dns_name]
    Champ Description
    Nom [name] Nom ou adresse IP unique de l’hôte DNS.
    Adresse IP [ip_address] Adresse IP de l’hôte DNS.
    Figure 2. Amazon Vue des dépendances de passerelle API
    CI et connexions de passerelle API aWS sur une carte Vue des dépendances

    Relations

    Découverte crée ces relations pour prendre en charge Amazon la détection de passerelle API.

    CI Relation CI
    Passerelle AWS API [cmdb_ci_aws_api_gateway] Fournit ::P fourni par API gérée [cmdb_ci_managed_api]
    API gérée [cmdb_ci_managed_api] Hébergé sur::Hôtes Centre de données AWS [cmdb_ci_aws_datacenter]
    API gérée [cmdb_ci_managed_api] Utilisations ::Utilisé par Nom DNS [cmdb_ci_dns_name]
    Nom DNS [cmdb_ci_dns_name] Hébergé sur::Hôtes Centre de données AWS [cmdb_ci_aws_datacenter]
    Valeur clé [cmdb_key_value] Références API gérée [cmdb_ci_managed_api]

    Découverte de balise

    Le modèle Amazon AWS API Gateway collecte des balises et les renseigne dans la table Valeur de clé [cmdb_key_value].

    Tableau 4. Valeur clé [cmdb_key_value]
    Champ Description
    Clé [key] Nom de balise.
    Valeur [value] Valeur de la balise.
    Élément de configuration [configuration_item] Fait référence à la table API gérée [cmdb_ci_managed_api].

    Connexions détectées par Mappage des services lors de la détection de haut en bas

    Mappage des services effectue la détection de haut en bas des passerelles AWS API dans le contexte des services d’application. Il détecte les connexions sortantes des passerelles AWS API :
    • AWS Lambda
    • Lien VPC pour cloud privé virtuel
    • Point de terminaison HTTP défini comme l’URL configurée sur la passerelle API