AWS-API-Gateway-Discovery

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer

    • Die ServiceNow DiscoveryUnd Service-MappingAnwendungen können AWS-API-Gateways und Verbindungen zu anderen Entitäten finden. Um einige dieser Ressourcen zu erkennen, muss aktualisiert werden Muster für Discovery und Service-MappingAnwendung von ServiceNow Store.

    DiscoveryUnd Service-MappingVerwenden Sie Amazon AWS API GatewayMuster zum Ausführen der horizontalen und von oben nach unten liegenden Discovery.

    Sie können dieses Muster für verwenden ServiceNowPlattform, die verwendet KingstonRelease oder höher.

    Apps im Store anfordern

    Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.

    Voraussetzungen

    AWS-Serviceaccount mit Anmeldeinformationen
    Auf Now Platform®, Richten Sie den Service-Account wie folgt ein:
    • Ein Account-ID , Dies ist die Amazon-Account-ID, zu der das API-Gateway gehört. Verwenden Sie die Konto-ID, wie sie in der AWS-Verwaltungskonsole angezeigt wird. Sie können Discovery über das Service-Account-Formular ausführen.
    • Die entsprechenden AWS-Anmeldeinformationen, die erforderlich sind, damit die Konten-ID die AWS-Cloud erreicht.

    Weitere Informationen finden Sie unter Serviceaccounts für DiscoveryUnd Service-MappingIn der Produktdokumentation.

    Update-Satz
    Wenn sich Ihre Instanz auf der Jakarta- oder Istanbul-Version befindet, importieren Sie den in bereitgestellten Update-Satz KB0679927 : AWS Lambda-Update-Satz für Top-Down-Discovery. Dieser Update-Satz ist für erforderlich Service-Mapping.
    Anwenderzugriff
    Geben Sie in der AWS-Konsole einem Anwender Berechtigungen zum Ausführen von an Apig:GET Funktion nur für die Aktion „ABRUFEN“ im API-Gateway.

    Daten erfasst von DiscoveryWährend der horizontalen Discovery

    Tabelle und Feld Zusätzliche Information
    Cloud-Gateway [cmdb_ci_cloud_gateway]
    Objekt-ID Die ID des Gateways.
    Kurzbeschreibung Die Kurzbeschreibung des Gateways.
    DNS-Name [cmdb_ci_dns_name]
    Name Der eindeutige Name oder die IP-Adresse des DNS-Hosts.
    IP-Adresse Die IP-Adresse des DNS-Hosts.
    AWS-Ressourcenname – Endpunkt [cmdb_ci_endpoint_arn]
    Host Der Hostname oder die IP-Adresse des Endpunkts.
    ARN Die ID (Amazon-Ressourcenname) anderer AWS-Entitäten, mit denen das Gateway eine Verbindung herstellt.

    Konfigurationselement (CI)-Beziehungen

    Diese Beziehungen werden erstellt, um die AWS API Gateway-Discovery zu unterstützen:
    CI Beziehung CI
    Cloud-Gateway

    [cmdb_ci_cloud_gateway]

    		 Verwendet:verwendet von DNS-Name

    [cmdb_ci_dns_name]
    Gehostet auf:Hosts AWS-Rechenzentrum [cmdb_ci_aws_datacenter]

    Das AWS-Rechenzentrum hat Beziehungen zu anderen AWS-CIs, z. B. Verfügbarkeitszonen, Service-Accounts usw. Weitere Informationen finden Sie in AWS und Azure Cloud Discovery in der Produktdokumentation.

    Verbindungen erkannt von Service-MappingWährend der Discovery von oben nach unten

    Service-Mapping Führt die Top-Down-Discovery der AWS-API-Gateways im Kontext von Anwendungsservices durch. Es erkennt ausgehende Verbindungen der AWS-API-Gateways:
    • AWS Lambda
    • VPC-Link für Virtual Private Cloud
    • HTTP-Endpunkt, der als konfigurierte URL im API-Gateway definiert ist

    Problembehandlung

    Wenn der Zuordnungsprozess nicht wie erwartet fortgesetzt wird, befolgen Sie die folgenden Vorschläge.
    Symptom Ursache Lösung
    Discovery schlägt fehl. Die Discovery-Nachricht enthält die Informationen zu einem Fehler, der durch die REST-Zeitüberschreitung verursacht wurde. Es gibt viele CIs, die die REST-Aufrufantwort in der Bereitstellung senden. Die MID-ServerDie REST-Aufrufantwort kann nicht verarbeitet werden, ohne die von gesteuerte Zeitgrenze zu überschreiten mid.sa.cloud.request_timeoutParameter. Standardmäßig ist mid.sa.cloud.request_timeoutParameter ist auf 30000 Millisekunden festgelegt.
    Erhöhen Sie den Wert dieses Parameters für den relevanten MID-ServerUnd führen Sie die Discovery erneut aus.
    Hinweis:
    Wenn Konfigurationsparameter Zugehörige Liste für relevant MID-ServerZeigt diesen Parameter nicht an. Möglicherweise müssen Sie ihn hinzufügen.
    Musterdesigner Schlägt während einer Debug-Sitzung fehl. Die MusterdesignerDie Nachricht enthält Informationen zu einem Fehler, der durch eine Zeitüberschreitung verursacht wurde. Die MusterdesignerSchlägt aufgrund einer Zeitüberschreitung beim Muster-Debugging (und nicht während der Discovery) fehl. Standardmäßig ist sa.debugger.max_timeoutParameter ist auf 240 Sekunden festgelegt.

    Erhöhen Sie den Wert dieses Parameters für den relevanten MID-Server.