Elemente zu Ihrer Assembly hinzufügen

Erstellen Sie Ihre API-Assembly mithilfe der Ansicht Assemblieren in API Designer. Sie können die Ansicht „Assemble“ aufrufen, indem Sie im API-Editor auf die Registerkarte „Gateway“ klicken.

Informationen zu dieser Task

Hinweis: Diese Task bezieht sich auf die Konfiguration einer OpenAPI 2.0 . Details zum Konfigurieren einer OpenAPI 3.0 -API-Definition finden Sie unter Bearbeiten einer OpenAPI 3.0 -API-Definition.

Sie können diese Task entweder mithilfe der UI-Anwendung API Designer oder mithilfe der browserbasierten Benutzerschnittstelle von API Manager ausführen.

Sie können das Assembliertool in der Benutzerschnittstelle verwenden, um Assemblys zu erstellen, die zur Verarbeitung von Anforderungen an oder Antworten auf Ihre API-Vorgänge verwendet werden.

Sie können jederzeit direkt zur zugrunde liegenden YAML-Quelle von „ OpenAPI “ wechseln, indem Symbol für OpenAPI -QuelleSie auf das Symbol „Quelle“ klicken. Um zum Entwurfsformular zurückzukehren, klicken Sie auf das Formular -Symbol Formularsymbol.

Wenn Sie die Ansicht Quelle verwenden möchten, um die Quelle Ihrer API-Definition zu bearbeiten, finden Sie weitere Informationen zur Konfiguration der YAML-Datei OpenAPI unter execute OpenAPI extension .

Weitere Informationen zur Verwendung des Assemblierungs-Tools finden Sie unter „Der Assemblierungs-Editor “.

Vorgehensweise

Führen Sie die folgenden Schritte aus, um Elemente mithilfe des Assembliertools zu Ihrer Assembly hinzuzufügen:
  1. Klicken Sie im Navigationsbereich auf Symbol 'Entwickeln' im Navigationsfenster „Entwickeln “ und wählen Sie dann die Registerkarte „APIs“ aus.
    Die Seite Entwickeln wird angezeigt.
  2. Klicken Sie auf den Titel der API-Definition, mit der Sie arbeiten möchten.
  3. In der Ansicht Richtlinien können Sie ein Element hinzufügen.
    Hinweis Sie müssen eine Version für die Richtlinie angeben. Um Fehler aufgrund inkompatibler Richtlinienversionen zwischen der API und dem Gateway zu vermeiden, API Connect wird eine API nur dann an das Gateway gesendet, wenn die Richtlinienversion in der API genau mit der auf dem Gateway vorhandenen Version übereinstimmt.
    1. Wählen Sie die Registerkarte Gateway aus und klicken Sie dann im Navigationsfenster auf Richtlinien .
    2. Klicken Sie an der gewünschten Stelle auf der Arbeitsfläche auf das Pluszeichen in einem Kreis Plus-Symbol, um die Palette mit den verfügbaren Elementen anzuzeigen.
    3. Wählen Sie das Element, das Sie aus der Palette auf die Arbeitsfläche ziehen möchten, durch Anklicken aus.
      Hinweis:
      • Elemente werden in der Reihenfolge vom anfänglichen, nicht ausgefüllten Kreis zum letzten, ausgefüllten Kreis angewendet.
      • Wenn kein operation-switch-Element verwendet wird, gilt die gesamte Assembly für alle Vorgänge in der API.
    4. Fügen Sie die Elementeigenschaften hinzu und bearbeiten Sie sie, indem Sie auf das Element klicken und das Eigenschaftenfenster verwenden.
      Bei manchen Elementen können Sie Eigenschaften hinzufügen und entfernen, indem Sie auf Object Properties (Objekteigenschaften) klicken und die Eigenschaft aus der Dropdown-Liste auswählen. Informationen zu den Eigenschaften von Richtlinienelementen finden Sie unter „API-Richtlinien und Logikkonstrukte “. Informationen zu den Eigenschaften logischer Konstrukte finden Sie unter „Logische Konstrukte “.
    5. Geben Sie eine Version für die Richtlinie an
      Um eine Version hinzuzufügen, klicken Sie auf das Symbol Symbol für OpenAPI -Quelle„Quelle“ und füllen Sie den version Abschnitt der YAML-Datei der Richtlinie aus. Zum Beispiel:
      execute:
        - invoke:
            version: 2.2.0
            title: invoke
      ...
      Sie müssen eine Version für die Richtlinie angeben, die mit dem Gateway kompatibel ist, das Sie verwenden. Wenn die API veröffentlicht wird und die Version nicht mit dem Gateway kompatibel ist, wird ein Gültigkeitsfehler ausgelöst, der die verfügbaren Versionen angibt. Weitere Informationen zum Konfigurieren der YAML-Datei für die Richtlinie OpenAPI finden Sie unter execute OpenAPI extension.
  4. Optional: Wiederholen Sie die Schritte unter 3.b bis 3.e für alle weiteren Elemente, die Sie hinzufügen möchten.
  5. Klicken Sie auf Speichern , um Ihre Änderungen zu speichern.

Ergebnisse

Sie haben ein oder mehrere Elemente zu Ihrer Assembly hinzugefügt.