Cloud API-Pfad

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer
  • Der Cloud API-Pfad ist ein Aktivitätsprotokoll für alle Aktivitäten, die die Cloud API verwenden und den MID-Server durchlaufen.

    Inhalte des Cloud API-Pfads

    Abbildung : 1. CAPI-Pfadformular
    Das Formular „Cloud-API-Pfad“
    Feld Beschreibung
    ID der dynamischen Route Eine automatisch generierte ID-Nummer für den Eintrag.
    MID-Name Der Name des MID-Server s, über den die Discovery ausgeführt wurde.
    Routenstatus Gibt an, ob der von der API ausgeführte Discovery-Vorgang erfolgreich war. Mögliche Werte sind:
    • Erfolg
    • Fehler
    • Wird ausgeführt
    Eingabeparameter Der Eingabeparameter, von dem der API-Pfad-Datensatz generiert wurde. Dieser Wert ist normalerweise das Rechenzentrum, in dem Discovery ausgeführt wurde.
    Schnittstellenname
    Aufgerufen durch Dieser Wert ist immer CMP, wenn Discovery ausgeführt wird.
    Methodenname Der Schnittstellenvorgang von der Cloud-API, von der dieser Datensatz verarbeitet wurde.
    Providername Der Cloud Provider
    Version Die in der Cloud-API angegebene Version

    CAPI-Pfadprotokolle

    Die zugehörige Liste „CAPI-Pfadprotokolle“ enthält weitere Details zum Eintrag des Cloud API-Pfads. Die folgenden Protokollschlüsseltypen sind verfügbar:

    Protokollschlüssel Beschreibung
    route_data Informationen zu den Cloud-API-Aufrufen
    dynamic_route Informationen über die tatsächliche Route, über die die Daten geflossen sind, einschließlich URIs.
    route_result Die von der Instanz empfangene Nutzlast oder eine Beschreibung des Ergebnisses der Datenübertragung. Die Nutzlast
    chunk_number Die Anzahl der Datenblöcke, die die Instanz empfangen hat
    route_status Gibt an, ob die Routenverbindung und die Übertragung der Nutzlast erfolgreich war
    route_error Der aufgetretene Fehler. Zum Beispiel der Fehler Failed to list loadbalancer Failed: HTTP-Fehlercode: 403 (Auflistung des Lastenausgleichsmoduls fehlgeschlagen: HTTP-Fehlercode: 403) bedeutet, dass Ihre Anmeldeinformationen falsch waren und Discovery nicht auf die Cloud-Ressource zugreifen konnte.
    error_detail Weitere Details über den Fehler, einschließlich der Cloud Provisioning and Governance-API und des entsprechenden Connectors, der beim Discovery-Versuch verwendet wurde, und die Fehler, die der Cloud Provider ausgegeben hat.
    Beispiel für einen „route_error“:
    Failed to list loadbalancer Failed : HTTP error code : 403

    Beispiel für den Eintrag „error_detail“ für denselben Fehler:

    com.snc.cmp.connector.cloud.loadbalancer.component.LoadBalancerException: Failed to list loadbalancer Failed : HTTP error code : 403
           at com.snc.cmp.connector.cloud.loadbalancer.customizer.impl.AWSLoadBalancerCustomizer.listLoadBalancers(AWSLoadBalancerCustomizer.java:56)
    	at com.snc.cmp.connector.cloud.loadbalancer.component.LoadBalancerProducer.process(LoadBalancerProducer.java:46)
    	at org.apache.camel.util.AsyncProcessorConverterHelper$ProcessorToAsyncProcessorBridge.process(AsyncProcessorConverterHelper.java:61)
           at org.apache.camel.processor.SendProcessor.process(SendProcessor.java:145)
           ...

    In diesen beiden Einträgen wird angegeben, dass die Anmeldeinformationen falsch waren und Discovery nicht auf die Cloud-Ressource zugreifen konnte. Die Schnittstelle des Lastenausgleichsmoduls gibt den ersten Fehler aus, da das Lastenausgleichsmodul das erste Gerät ist, das Zugriff auf die Cloud-Ressource ermöglicht. Die Fehler org.apache.camel weisen auf Weiterleitungsfehler aufseiten von Amazon Web Services hin.

    Der entsprechende Fehler auf der Instanzseite wird im Cloud-Orchestrierungspfad erfasst.

    Cloud API-Pfad öffnen

    Öffnen Sie den Cloud API-Pfad, um Probleme wie fehlgeschlagene Richtlinien oder fehlgeschlagene Discovery von Cloud-Ressourcen zu debuggen und zu beheben.

    Vorbereitungen

    Erforderliche Rolle: sn_cmp.cloud_operator oder sn_cmp.cloud_admin

    Prozedur

    1. Navigieren Sie im Cloud-Administratorportal zu Betreiben > Pfadean.
    2. Auf der Registerkarte Cloud API-Pfad filtern und sortieren Sie die Liste der Datensätze aus dem Cloud API-Pfad nach Bedarf.
      Wenn Sie z. B. nach einer fehlgeschlagenen Discovery suchen, filtern Sie die Liste, sodass in der Spalte Routenstatus nur Einträge mit Fehler anzeigt werden.
    3. Klicken Sie auf einen Link in der Spalte „Erstellt“, um den Datensatz des Cloud API-Pfads zu öffnen.
    4. Öffnen Sie in der zugehörigen Liste „CAPI-Pfadprotokolle“ den Protokolldatensatz, der die gewünschten Informationen anzeigt.
      Öffnen Sie beispielsweise route_error oder error_detail, um einen fehlgeschlagenen Vorgang zu debuggen.