Bekannte Einschränkungen

Online bearbeiten

Auf dieser Seite werden die bekannten Einschränkungen für API Connect beschrieben.

Hinweis: Die Einschränkungen, die auf dieser Seite dokumentiert sind, werden entfernt, da sie im Produkt API Connect behandelt werden. Die neueste Liste mit Produkteinschränkungen finden Sie in der englischen Version dieser Seite.

Analyse

Instana AutoTrace und die Eingabe von „ Dynatrace “ wird in bestimmten Subsystemen nicht unterstützt

Instana AutoTrace wird in den Teilsystemen „Management“, „Analytics“, „Developer Portal “ und „Gateway“ nicht unterstützt. Die Verwendung von Instana AutoTrace in diesen Subsystemen kann zu Datenbeschädigungen führen; außerdem wird die Einbindung von Dynatrace im Developer-Portal -Subsystem nicht unterstützt und kann ebenfalls zu Datenbeschädigungen führen. Weitere Informationen finden Sie unter Instana AutoTrace.

Hinweis:
  • OpenTelemetry Die auf dem basierende DataPower® API Gateway Nachverfolgung wird unterstützt und ist die empfohlene Methode. Weitere Informationen finden Sie unter „ OpenTelemetry -Konfiguration aktivieren “.
  • Dieses Problem geht auf die Integration von „ Instana “ zurück und steht in keinem Zusammenhang mit API Connect.
Draft comment: felbin.james@ibm.com
Updated Jul 2024 https://jsw.ibm.com/browse/APICON-10777 SME: Chris Dudley
Einschränkungen für Analysebefehle
Draft comment: jendavidse@uk.ibm.com
https://github.ibm.com/velox/docs/issues/4546 SME: Pablo Lopez Rodriguez
Die folgenden --mode analytics -Befehle funktionieren nur, wenn das Flag --return_format auf json oder yamlgesetzt ist:
  • clustermgmt:catAllocation
  • clustermgmt:catIndices
  • clustermgmt:catNodes
  • clustermgmt:catRecovery
  • clustermgmt:catShards
  • clustermgmt:catAliases
Die folgenden Befehle funktionieren derzeit nicht in der Toolkit-CLI, da sie nur text/plainzurückgeben:
  • clustermgmt:getNodesHotThreads
  • clustermgmt:getNodesHotThreadsById

Benachrichtigungen zu Verbraucherratenbegrenzungen sind in Version 10 nicht verfügbar.
Draft comment: jendavidse@uk.ibm.com
https://github.ibm.com/velox/docs/issues/4287 SME: Swetha Sridharan
Die Möglichkeit, Benachrichtigungen für Anwendungen zu konfigurieren, sodass API-Konsumenten benachrichtigt werden, wenn die Nutzung einer API ihre Ratenbegrenzung fast erreicht, ist nicht verfügbar.

API-Governance

Bei der Validierung innerhalb eines Regelsatzes werden alle Regeln angezeigt
Wenn Sie im Governance -Dienst innerhalb eines Regelsatzes auf „Validieren“ klicken, enthält die angezeigte Liste auch Regeln, die nicht Teil des ausgewählten Regelsatzes sind. Um dieses Problem zu umgehen, wählen Sie die Regeln, die Sie für die Validierung verwenden möchten, manuell aus.
Draft comment: jendavidse@uk.ibm.com
https://github.ibm.com/velox/docs/issues/6139 SME: John Murphy

API-Manager

Ein OAuth-Provider schlägt fehl, wenn die Ressourcen, auf die er verweist, nicht im Katalog aktiviert sind
Draft comment: garychapman
https://github.ibm.com/velox/docs/issues/1139, https://github.ibm.com/velox/velox/issues/2995
Wenn Sie einen „ OAuth “-Anbieter in einem Katalog aktivieren, müssen alle Ressourcen, auf die er verweist – wie beispielsweise API-Benutzerregister oder „ TLS “-Client-Profile – im selben Katalog aktiviert sein; andernfalls wird der „ OAuth “-Anbieter zwar erfolgreich veröffentlicht, schlägt jedoch zur Laufzeit fehl. Informationen zum Aktivieren von Ressourcen in einem Katalog finden Sie unter Erstellen und Konfigurieren von Katalogen.

Falsches Verhalten der Benutzerschnittstelle, wenn API-Änderungen vor dem Erstellen einer neuen API-Version nicht gespeichert werden
Draft comment: garychapman
https://github.ibm.com/velox/docs/issues/2252, https://github.ibm.com/velox/ui/issues/22848, SME = Viet Nguyen
Wenn Sie Änderungen an einer API-Definition vornehmen und anschließend versuchen, eine neue API-Version zu erstellen, ohne zuerst Ihre Änderungen zu speichern, werden Sie erst dann zum Speichern Ihrer Änderungen aufgefordert, wenn Sie die Operation zum Erstellen der neuen Version abgeschlossen haben. Wenn Sie in der Eingabeaufforderung auf OK klicken, wird Ihre neue Version erstellt, aber Ihre ursprünglichen Änderungen gehen verloren. Wenn Sie Ihre neue Version erstellen und Ihre ursprünglichen Änderungen beibehalten möchten, sollten Sie in der Eingabeaufforderung auf Abbrechen und dann auf Speichern klicken, um Ihre ursprünglichen Änderungen zu speichern.

Die gleichzeitige Bearbeitung derselben API durch mehrere Benutzer kann dazu führen, dass Änderungen überschrieben werden
Draft comment: garychapman
https://github.ibm.com/velox/docs/issues/3059, https://github.ibm.com/velox/docs/issues/3059, SME = Ivy Ho
Wenn ein Benutzer Änderungen an einer OpenAPI 3.0 -API speichert, werden die Änderungen möglicherweise von einem anderen Benutzer überschrieben, der dieselbe API im API-Editor geöffnet hat.

Ein vorhandener Benutzer kann nicht zu einem Bereich hinzugefügt werden
Draft comment: garychapman
https://github.ibm.com/velox/docs/issues/3058, https://github.ibm.com/velox/ui/issues/26082, SME = Ivy Ho
Wenn Sie versuchen, einem Bereich einen vorhandenen Benutzer hinzuzufügen, kann die Operation nicht ausgeführt werden, da die Schaltfläche Erstellen nicht aktiviert ist. Verwenden Sie stattdessen den Einladungsmechanismus. Details finden Sie unter Bereichszugehörigkeit verwalten.
Hinweis: Der eingeladene Benutzer muss die Option Anmelden im Aktivierungsformular verwenden, anstatt die Registrierungsdetails auszufüllen und Anmeldenzu verwenden.
Eine veröffentlichte API, deren Assembly einen Catch-Block mit einer ungültigen Richtlinie enthält, kann jetzt nicht ordnungsgemäß erneut veröffentlicht werden.
Draft comment: garychapman
https://github.ibm.com/velox/docs/issues/3300, https://github.ibm.com/apimesh/scrum-datapower/issues/10088, SME = Yahel Nachum
Bisher wurden Richtlinien in einem Assembly-Catch-Block nicht validiert. Wenn also eine falsche Richtlinienkonfiguration in der OpenAPI -Quelle für eine API codiert wurde, würde die API in einem Assembly-Catch-Block trotzdem erfolgreich veröffentlicht. Jetzt werden Richtlinien in einem Assembly-catch-Block validiert, sodass eine solche API nicht erneut veröffentlicht werden kann und zuerst korrigiert werden muss.

Cloud-Manager

API Connect „Enterprise as a Service“ unterstützt keine privaten Endpunkte für APIs
Bei API Connect „Enterprise as a Service“ können APIs nur über das öffentliche Netzwerk aufgerufen werden. Private Endpunkte werden nicht unterstützt.
Draft comment: elizabeth_bowling@us.ibm.com
https://ibm.ent.box.com/notes/909906056089 RMoorhouse

Gateway

WebSocket unterstützung

API Connect bietet die grundlegende Funktionalität von WebSocket über die Richtlinie websocket-upgrade . Bei der Entwicklung von APIs, die die WebSocket Kommunikation nutzen, sind jedoch wichtige Einschränkungen zu beachten.

  1. Allgemeine Einschränkungen
    • Die maximale Nutzlast einer zuverlässigen Nachricht beträgt weniger als 1 KB.
    • Das Versenden mehrerer Nachrichten in schneller Folge kann die Kumulierungsgrenzen überschreiten. So können beispielsweise drei aufeinander folgende 500-Byte-Nachrichten fehlschlagen.
    • Nachrichten bis zu 100 Byte können zuverlässig übertragen werden, wenn sie mit einer Verzögerung von mindestens 10 Millisekunden gesendet werden.
    • Senden Sie Daten in Intervallen von mehr als 10 Millisekunden, um Verbindungsabbrüche oder Gateway-Probleme zu vermeiden.
    • WebSocket komprimierungs- und Streaming-Modi werden nicht unterstützt.
  2. Einschränkungen bei der Fehlerbehandlung
    • Wenn ein Server eine Verbindung mit dem Statuscode 1000, 1006 oder 1008 schließt, erhält der Client den Code 1006, unabhängig von der tatsächlichen Ursache.
    • Wenn der Server abstürzt, erhält der Client weder ein Beendigungsereignis noch eine Fehlermeldung von DataPower Gateway.
    • Fehler können abgefangen werden:
      • In der Hauptgruppe, bevor die Richtlinie websocket-upgrade ausgeführt wird.
      • In Unterbaugruppen während der Nachrichtenverarbeitung nach dem Upgrade, die aus einer Unterbaugruppenaktion stammen.
    • Fehler während der Verbindungen von WebSocket oder nach der Trennung der Verbindung können nach Abschluss der Aktualisierung nicht mehr erkannt werden.
  3. Unterstützung von Opcodes und Datentypen
    • Es werden nur Textrahmen unterstützt.
    • Binäre Rahmen werden nicht unterstützt.
  4. Richtlinieneinschränkungen nach dem Upgrade
    • Nach dem Upgrade von WebSocket werden die folgenden Aktionen und Eigenschaften in den Unterbaugruppen nicht mehr unterstützt:
      • Clientsicherheit
      • JWT generieren
      • Benutzersicherheit
      • JWT validieren
      • Kundenidentifizierung
      • Aktivitätenprotokoll
      • HTML-Seite
      • WebSocket aktualisieren
      • Parsen:
        • Inhaltstyp verwenden
        • Bei leerer Eingabe warnen
    • Nach dem Upgrade sind in der Hauptgruppe keine Aktionen mehr erlaubt.
    • Nur Unterbaugruppen, die unterstützte Eigenschaften verwenden, können nach dem Upgrade Nachrichten verarbeiten.
Draft comment: felbin.james@ibm.com
Updated Jul 2024 https://jsw.ibm.com/browse/APICON-8555 SME: Yahel Muirhead-Nachum
Das Schwärzen bei ungültigem XPath schlägt nach der Konvertierung fehl DataPower API Gateway
Draft comment: felbin.james@ibm.com
https://jsw.ibm.com/browse/APICON-4557
Redact bei ungültigem XPath schlägt nach der Umwandlung in ' DataPower API Gateway fehl. Die Application Management Unit (AMU) der Version 10.0.8.0-R0 unterstützt die Konvertierung der Redact-Richtlinie, jedoch nur in die Redact-Version 1.5.0 und nicht in 2.0.0

Neubearbeitungsbedingungen in switch-, operation-switch-oder if -Richtlinien werden nach der Konvertierung in DataPower API Gateway möglicherweise nicht ausgeführt
Draft comment: slaflamm.ibm.com
https://github.ibm.com/velox/docs/issues/1357
Wenn eine Richtlinie API Connect vom Typ „ v5-compatibleredact “ in einer Richtlinie vom ifswitch Typ „,“, operation-switch „, “ oder „“ gefunden wird, verschiebt das Migrationsprogramm diese redact Richtlinie nicht an den Anfang oder das Ende der Sammlung. Der Unterschied in der Reaktion zwischen „ API Connectv5 “ und „“ DataPower API Gateway könnte dazu führen, dass Daten in der Datei nicht DataPower API Gatewaygeschwärzt werden.

Wenn z. B. eine Assembly eine switch-Richtlinie umfasst, die vier Bedingungen zum erneuten Bearbeiten gefolgt von einer invoke-Richtlinie enthält, führt jede Bedingung zum erneuten Bearbeiten eine Neubearbeitung der Antwortdaten durch. Nach der Portierung auf das API-Gateway verbleiben die Bedingungen zum erneuten Bearbeiten innerhalb der switch-Richtlinie und arbeiten mit der Eigenschaft message.body als Ziel zur Neubearbeitung. Die Ausführung dieser Neubearbeitungen schlägt fehl, da die Eigenschaft message.body noch nicht von der invoke-Richtlinie abgerufen wurde. Um dieses Problem zu lösen, müssen Sie die invoke-Richtlinie so verschieben, dass sie vor der switch-Richtlinie in der Assembly steht.

Parse-Policy-Beschränkung
  • Die Eigenschaft literal in der Parse-Richtlinie unterstützt keine Variablen oder Kontextparameter. Es muss eine feste Zeichenfolge sein.

Entwicklerportal

Das SameSite -Cookie 'strict' führt zu falschen Einladungen an Konsumentenorganisationen
Draft comment: ElizabethBowling
https://github.ibm.com/velox/docs/issues/3922
Die Verwendung des SameSite -Cookies 'strict' kann Einladungslinks von E-Mails verursachen, um Benutzer an eine Registrierungsseite zu senden, auf der sie aufgefordert werden, eine neue Konsumentenorganisation zu erstellen, anstatt an der Organisation teilzunehmen, zu der sie eingeladen wurden.

Als Ausweichlösung können Sie das SameSite -Cookieattribut 'Lax' verwenden.

Toolkit

Bei der Anmeldung im API Designer mit Local Test Environment über https://localhost schlägt die Anmeldung mit der Fehlermeldung „Falscher Benutzername, falsches Passwort oder falsche Anmeldedaten“ fehl
Wenn Sie den API-Designer mit dem lokalen Server „ Test Environment “ verwenden und versuchen, sich über „localhost“ anzumelden, schlägt die Anmeldung fehl. Sie können das Problem umgehen, indem Sie die Anmeldedaten für den API Designer so konfigurieren, dass sie den lokalen Host verwenden. Führen Sie die folgenden Schritte aus:
  1. Laden Sie den API Designer herunter und entpacken Sie ihn. Installieren Sie anschließend die Anmeldedaten-Datei wie unter beschrieben.

  2. Bearbeiten Sie die designer_credentials.json Datei und nehmen Sie folgende Einstellungen vor:
    • "endpoint": "https://localhost"

    • "manager_endpoint": "https://localhost/manager"

    • "client_id": Client Id

      Die Client-ID wird beim Starten des LTE auf der Konsole platform-apic-lte angezeigt. Weitere Informationen finden Sie unter „Testen einer API mit dem Local- Test Environment “.

    • "client_secret": Client Secret

      Das Client-Geheimnis wird auf der Konsole angezeigt, wenn Sie LTE starten platform-apic-lte. Weitere Informationen finden Sie unter „Testen einer API mit dem Local- Test Environment “.

  3. Starten Sie den API Designer und melden Sie sich beim LTE mit https://localhost als Host- URL (dem Verwaltungs-Endpunkt) an.
Draft comment: elizabeth_bowling@us.ibm.com
https://github.ibm.com/velox/docs/issues/5394 Rashmi Hunt

API Designer blockiert möglicherweise, während eine große importierte API aktiviert wird.
Wenn Sie eine große API mit API Designer importieren und versuchen, die API im Importassistenten zu aktivieren, kann der Prozess blockieren. Wenn dieses Problem auftritt, können Sie es umgehen, indem Sie die folgenden Schritte ausführen:
  1. Suchen Sie in Ihrem lokalen Dateisystem die Autoproduktdatei mit dem Namen API-NAME-auto-product_API-VERSION.yaml.
  2. Löschen Sie die Datei.
  3. Bearbeiten Sie in API Designer die neu importierte API und aktivieren Sie sie, indem Sie auf die Umschaltfläche 'Online' klicken.

Im Allgemeinen ist es ein bewährtes Verfahren, eine API über die Umschaltfläche Online oder durch Veröffentlichung der API mit der Option Veröffentlichen zu aktivieren.

Draft comment: elizabeth_bowling@us.ibm.com
https://github.ibm.com/velox/docs/issues/5107 SME R Hunt
API Designer unter Windows: Bei APIs, die WSDL verwenden, können Fehler auftreten oder sie können nicht aktiviert, veröffentlicht oder aktualisiert werden.
Wenn Sie eine REST-oder SOAP-API, die eine WSDL-Datei verwendet, aktivieren, veröffentlichen oder aktualisieren, schlägt die Operation möglicherweise fehl und wird nie abgeschlossen. Umgehen Sie das Problem, indem Sie das Feature autopublish API im API-Editor verwenden.
Draft comment: elizabeth_bowling@us.ibm.com
https://github.ibm.com/velox/docs/issues/5096 SME:Ivy Ho

Berechtigungseinschränkungen in der Benutzerschnittstelle von API Designer
Für die Benutzerschnittstelle von API Designer gelten derzeit die folgenden Berechtigungseinschränkungen:
  • Entwickler, denen nur die Berechtigung Anzeigen erteilt wurde, können die Registerkarte Testen im API-Editor nicht anzeigen. Damit Entwickler die Registerkarte Test anzeigen können, muss ihnen eine andere Berechtigungsstufe erteilt werden. Informationen zu den verfügbaren Standardberechtigungsstufen finden Sie unter API Connect -Benutzerrollen.
  • Benutzer mit der Berechtigung API-Entwürfe , aber ohne Sandbox-Katalogberechtigungen können die Testvorgaben nicht im Sandbox-Katalog anzeigen. Damit diese Benutzer die Testeinstellungenanzeigen können, muss ihnen die Rolle Entwickler oder Administrator für den Sandbox-Katalog zugewiesen werden.
Draft comment: jendavidse@uk.ibm.com
https://github.ibm.com/velox/docs/issues/4468 SME: Ivy Ho
Gelöschte Sicherheitsanforderungen verbleiben möglicherweise in der API-Quelle
Sicherheitsanforderungen, die aus APIs in den Benutzerschnittstellen von API Designer und API Manager gelöscht werden, verbleiben möglicherweise weiterhin in der Quelle. Um dieses Problem zu umgehen, klicken Sie im API-Editor auf das Symbol für OpenAPI -Quelle Symbol „Quelle“ und entfernen Sie die Sicherheitsanforderungen manuell.
Draft comment: jendavidse@uk.ibm.com
https://github.ibm.com/velox/docs/issues/4937 SME: Ivy Ho

Hinzufügen von Kommentaren zu APIs über die Quellenansicht in den Benutzerschnittstellen von API Designer und API Manager nicht möglich
In den Benutzeroberflächen des API Designers und des API Managers können keine Kommentare zu APIs hinzugefügt werden, indem man auf das Symbol für OpenAPI -Quelle Quellcode -Symbol klickt und das Hashtag-Symbol verwendet.
Draft comment: jendavidse@uk.ibm.com
https://github.ibm.com/velox/docs/issues/4654 SME: Jisoo Lee

Durch das Ändern der Produktsichtbarkeit von Benutzerdefiniert in Öffentlich werden die Konsumentenorganisationen und -gruppen nicht automatisch entfernt
Wenn Sie in den Benutzerschnittstellen von API Designer und API Manager die Produktsichtbarkeit von Angepasst in Öffentlich ändern, werden die Konsumentenorganisationen und -gruppen nicht automatisch entfernt, sodass die Produktveröffentlichung fehlschlägt. Um dieses Problem zu umgehen, entfernen Sie manuell alle Konsumentenorganisationen und -gruppen.
Draft comment: jendavidse@uk.ibm.com
https://github.ibm.com/velox/docs/issues/4759 SME: Ivy Ho

Einschränkungen bei der Unterstützung von OpenAPI 3.0
Draft comment: jennydavidse
https://github.ibm.com/velox/docs/issues/4118 Sanjay Nayak - keep this KL until there are no limitations to the OAI3.0 support.
IBM® API Connect unterstützt die Spezifikation OpenAPI 3.0 mit einigen Einschränkungen. Informationen zu den unterstützten Komponenten finden Sie unter Unterstützung fürOpenAPI 3.0.

Eine GraphQL -API, die eine graphql-input-type-cost -Ratenbegrenzung enthält, kann nicht veröffentlicht werden.
Draft comment:
https://github.ibm.com/velox/docs/issues/3792, https://github.ibm.com/velox/ui/issues/28072, SME = Di Zhang
Eine GraphQL -API, die in Releases vor IBM API Connect Version 10.0.3.0 erstellt wurde, enthält möglicherweise eine graphql-input-type-cost -Ratenbegrenzung, die nicht mehr unterstützt wird. Wenn Sie versuchen, den automatischen Aktivierungsmechanismus zum Veröffentlichen der API zu verwenden oder die API manuell zu einem Produkt hinzuzufügen und versuchen, dieses Produkt zu veröffentlichen, schlägt die Veröffentlichungsoperation fehl. Sie können dieses Problem auf eine der folgenden Arten beheben:
  • Entfernen Sie die Ratenbegrenzungsdefinition aus der OpenAPI -Quelle für die API. Wenn die Quelle beispielsweise im YAML-Format vorliegt, entfernen Sie die folgenden Zeilen:
    - name: graphql-input-type-cost
  operation: consume
  • Bearbeiten Sie die Quelle für das Produkt und definieren Sie eine graphql-input-type-cost -Ratenbegrenzung in allen Plänen, die die API enthalten.
    Hinweis: Sie können nur ein manuell erzeugtes Produkt bearbeiten, nicht ein Produkt, das vom automatischen Aktivierungsmechanismus generiert wird.

Eine API mit doppelten Sicherheitsdefinitionseinträgen kann nicht veröffentlicht werden.
Draft comment: jennydavidse
Limitation still valid. New tracking issue: https://github.ibm.com/velox/planning-abandoned-/issues/432
Draft comment: garychapman
AWAITING REVIEW (CHANDRIKA GOLE), REVIEWED BY SAVIO RODRIGUES
Mit den Benutzerschnittstellen von API Designer und API Manager können Sie einer API doppelte Sicherheitsdefinitionen hinzufügen. Versuche, die API zu veröffentlichen, schlagen jedoch mit OpenAPI-Validierungsfehlern fehl. Stellen Sie sicher, dass die Sicherheitsdefinitionen in einer API eindeutig sind.

Keine Option zum massenhaften Löschen von APIs oder Produkten
Draft comment: jennydavidse
New tracking issue from Simon Ho: https://github.ibm.com/velox/ui/issues/16691 Jun2019
Draft comment: garychapman
Still awaiting fix; original dev issue closed, waiting on a new tracking issue from Simon Ho - https://github.ibm.com/velox/ui/issues/10929 JenD Jun2019
Draft comment: garychapman
*** REVIEWED BY QUENTIN PRESLEY, SAVIO RODRIGUES ***
In den Benutzerschnittstellen von API Designer und API Manager gibt es derzeit keine Option zum Löschen mehrerer APIs oder Produkte in einer einzigen Operation. In den Benutzerschnittstellen müssen APIs und Produkte einzeln gelöscht werden. Sie können APIs und Produkte jedoch massenhaft löschen, indem Sie die REST-API-Schnittstelle oder die Befehlszeilenschnittstelle verwenden.

Feldprüfung für Clientsicherheitsrichtlinie ist fehlerhaft
Draft comment: garychapman
https://github.ibm.com/velox/docs/issues/1125, https://github.ibm.com/velox/ui/issues/15999
Beim Konfigurieren einer Clientsicherheitsrichtlinie in einer API-Assembly in der Benutzerschnittstelle von API Designer oder API Manager gibt es das folgende falsche Validierungsverhalten:
  • Das Feld ID-Name ist erforderlich, aber die API-Definition kann ohne Eingabe des Werts in diesem Feld gespeichert werden.
  • Das Feld Name des geheimen Schlüssels ist nur erforderlich, wenn die Option Geheimer Schlüssel erforderlich ausgewählt ist. Die Benutzerschnittstelle gibt jedoch an, dass das Feld Name des geheimen Schlüssels unabhängig davon erforderlich ist. Zudem kann die API-Definition ohne Eingabe eines Werts gespeichert werden, wenn das Feld erforderlich ist.
  • Wenn die Option Authentifizierungsclientmethode auf Drittanbieter gesetzt ist, ist das Feld Benutzerregistry-Name erforderlich, aber die API-Definition kann ohne Eingabe eines Werts in diesem Feld gespeichert werden.
Die Validierung für eine OpenAPI-Definition mit Regex-Syntax schlägt fehl
Draft comment: garychapman
https://github.ibm.com/velox/docs/issues/2300, https://github.ibm.com/velox/platform/issues/2477, SME = Ying Lu
IBM API Connect unterstützt die GO-Syntax für reguläre Ausdrücke. Wenn Sie eine OpenAPI -Definition in die Benutzerschnittstellen von API Designer oder API Manager importieren oder eine mit der apic validatevalidieren, schlägt die Validierung fehl, wenn die OpenAPI -Quelle eine nicht unterstützte reguläre Ausdruckssyntax mit Fehlern wie Does not match format 'regex'enthält. Beispiel:
- Must validate at least one schema (anyOf) (context: (root).paths./example/types.post.parameters.0.schema.properties.items, line: 0, col: 0)
- Must validate one and only one schema (oneOf) (context: (root).paths./example/types.post.parameters.0, line: 46164, col: 21)
- paths./example/types.post.parameters.0.schema.properties.items.properties.pattern Does not match format 'regex' (context: (root).paths./example/types.post.parameters.0.schema.properties.items.properties.pattern, line: 0, col: 0)
Richtlinieneinschränkungen überprüfen, wenn die GraphQL-Antwort einen GraphQL-Server-Fehler enthält
Draft comment: garychapman
https://github.ibm.com/velox/docs/issues/2905, https://github.ibm.com/apimesh/scrum-datapower/issues/8832, SME = Morris Matsa
Wenn eine GraphQL -Antwort einen GraphQL -Serverfehler und keine Daten enthält, generiert die Validierungsrichtlinie der Assembly einen Fehler für die fehlenden Daten und überschreibt die Nutzdaten. Wenn die Antwort Teildaten und einen Fehler enthält, überprüft die assembly Validate-Aktion die Daten und überschreibt die Nutzdaten. Um diese Einschränkung zu umgehen, verwenden Sie die Bedingung $not($exists(message.body.errors)) in einer Assembly-Switch-Bedingung, um die assembly-Validate-Richtlinie zu überspringen, wenn die Antwort Fehler enthält.

Für eine geschützte GraphQL -API können GraphQL -Abonnements nicht über die Registerkarte "Test" in den Benutzerschnittstellen getestet werden
Draft comment: garychapman
https://github.ibm.com/velox/docs/issues/3356, https://github.ibm.com/apimesh/scrum-datapower/issues/10254, SME = Don Carr
Für eine GraphQL -API, die durch Client-ID geschützt ist, können GraphQL -Subskriptionen nicht über die Registerkarte Test in der Benutzerschnittstelle von API Designer oder API Manager getestet werden. Die API kann weiterhin veröffentlicht und in der Produktion verwendet werden.
Sie können GraphQL -Subskriptionen auf eine der folgenden Arten testen:
  • Entfernen Sie die Client-ID-Sicherheit aus der API zu Testzwecken und verwenden Sie dann die Registerkarte Test .
  • Verwenden Sie ein externes Testtool.

Benutzerschnittstelle

Ein veralteter Cache kann zu unerwartetem Verhalten in der Benutzeroberfläche des API Managers führen
Ein veralteter Cache in Ihrem Browser kann zu unerwarteten Verhaltensweisen in der Benutzeroberfläche des API Managers führen, wie z. B. Abruffehler, die Anzeige falscher Daten und leere Seiten. Um dieses Problem zu umgehen, führen Sie bitte die folgenden Schritte aus:
  • Laden Sie das Browserfenster erneut.
  • Wenn das Problem weiterhin besteht, löschen Sie den Browser-Cache und melden Sie sich erneut an der Benutzerschnittstelle an.
  • Verwenden Sie ein privates Browserfenster.
  • Versuchen Sie nach Möglichkeit einen anderen Browsertyp.
Wenn die Probleme bestehen bleiben, wenden Sie sich an den IBM Support.
Draft comment: jendavidse@uk.ibm.com
https://github.ibm.com/velox/docs/issues/4622 SME: Ivy Ho

Einschränkungen des aktualisierten Schema-Editors für API-Definitionen
Der Abschnitt „Definitionen“ des API-Editors für die Benutzeroberflächen des API Managers und des API Designers wurde in API Connect. aktualisiert. Die OneOfEnum Schemastrukturen, AllOf, und werden von der Benutzeroberfläche jedoch nicht korrekt verarbeitet. Sie können dieses Problem umgehen, indem Sie die YAML-Quelldatei Ihres API-Dokuments bearbeiten.
Draft comment: jendavidse@uk.ibm.com
https://github.ibm.com/velox/docs/issues/5433 Justin Maly (two restrictions removed for 10.0.8)

Optionsmenüs im Katalog sind möglicherweise ausgeblendet
Wenn Sie in einem Katalog auf einer der verschiedenen Registerkarten wie „Kunden“ oder „Abonnements“ auf das Optionssymbol Symbol für Optionen klicken, sind die Menüpunkte möglicherweise ausgeblendet. Um das Problem zu umgehen, laden Sie die Seite erneut und die Menüelemente werden angezeigt.
Draft comment: jendavidse@uk.ibm.com
https://github.ibm.com/velox/docs/issues/4352 SME: Ivy Ho

Ratenbegrenzungen für Überschreibungspläne werden auf der Registerkarte Endpunkt nicht angezeigt.
Draft comment: jendavidse@uk.ibm.com
https://github.ibm.com/velox/docs/issues/4467 SME: Ivy Ho
Alle Überschreibungsgrenzwerte für Planraten, die Ihrer API für einzelne Operationen hinzugefügt wurden, werden auf der API-Registerkarte Endpunkt in der Benutzerschnittstelle nicht angezeigt. Nur die Planratenbegrenzung wird angezeigt.

Eine erneute Produktveröffentlichung mit der Option 'Abonnenten beibehalten' schlägt fehl, nachdem eine Konsumentenorganisationsgruppe aus den Sichtbarkeitseinstellungen entfernt wurde
Draft comment: garychapman
https://github.ibm.com/velox/docs/issues/3451, https://github.ibm.com/velox/ui/issues/27179, SMEs = Ahn Le, Nora Abdelgadir
Wenn Sie eine Konsumentenorganisationsgruppe aus den benutzerdefinierten Sichtbarkeitseinstellungen für ein Produkt entfernen und diese Gruppe eine Konsumentenorganisation mit einer Anwendung enthält, die das Produkt abonniert hat, schlägt der Versuch fehl, das Produkt mit der Option 'Abonnements beibehalten' erneut zu veröffentlichen, selbst wenn diese Konsumentenorganisation dann den benutzerdefinierten Sichtbarkeitseinstellungen einzeln hinzugefügt wird.

Die Einstellung für die Paginierung gilt global für alle API Connect Benutzeroberflächen
Draft comment: garychapman
https://github.ibm.com/velox/docs/issues/1602, https://github.ibm.com/velox/ui/issues/19329
Wenn Sie den Wert für „Elemente pro Seite“ auf einer beliebigen Seite in der Benutzeroberfläche des API-Managers festlegen, wird diese Einstellung anschließend auf alle Seiten in beiden Benutzeroberflächen derselben Browsersitzung angewendet. Wenn Sie den Wert für eine bestimmte Seite separat festlegen möchten, öffnen Sie sie in einem privaten Browserfenster. Eine solche Einstellung in einem privaten Browserfenster ist für dieses Fenster spezifisch und geht verloren, wenn das Fenster geschlossen wird.

Anmeldung an den Benutzerschnittstellen von API Connect schlägt bei Verwendung des Safari-Web-Browsers fehl
Draft comment: garychapman
https://github.ibm.com/velox/docs/issues/710, https://github.ibm.com/velox/ui/issues/13479
Wenn Sie den Safari-Web-Browser verwenden und für dieselbe DNS-Domäne, in der API Connect ausgeführt wird, ein Basisberechtigungsheader vorhanden ist, schlagen Anmeldeversuche bei den API Connect -Benutzerschnittstellen oder Anmeldeversuche über einen Aktivierungslink fehl. Verwenden Sie einen anderen Web-Browser, um dieses Problem zu vermeiden.

Die Anmeldung kann möglicherweise mit dem Fehler 431 fehlschlagen, wenn der Browser eine große Anzahl von Cookies enthält
Draft comment: garychapman
https://github.ibm.com/velox/docs/issues/1951, https://github.ibm.com/velox/platform/issues/1955, SME = Ying Lu
Der Anmeldeversuch kann fehlschlagen, wenn der Header „ HTTP “ oder die Cookie-Größe 32 KB überschreitet – eine Beschränkung, die aus Sicherheitsgründen gilt. Um dieses Problem zu lösen, löschen Sie entweder den Browser-Cache und die Cookies oder öffnen Sie ein privates Fenster und wiederholen Sie den Vorgang.

Umgang mit Zahlen in YAML-Konfigurationen und Genauigkeitsbeschränkungen in der Benutzeroberfläche des API-Managers
Draft comment: felbin.james@ibm.com
https://jsw.ibm.com/browse/APICON-4746
  • In den YAML-Konfigurationen der API-Manager-Benutzeroberfläche werden Zahlen in Exponentialschreibweise (z. B. 1e20 ) je nach Wert des Exponenten unterschiedlich behandelt. Zahlen mit einem Exponenten von höchstens 20 werden zur Anzeige und Verarbeitung in ihre vollständige ganzzahlige Form umgewandelt (zum Beispiel wird aus „ 1e20 “ die Zahl „100.000.000.000.000.000.000“). Zahlen mit einem Exponenten größer als 20 bleiben in der Exponentialschreibweise (zum Beispiel 1e21 ). Zahlen, die den von DataPower unterstützten Bereich ganzer Zahlen überschreiten (JSON-Schema-Validierung: ((-9,007,199,254,740,992 bis 9,007,199,254,740,992), führen zu Validierungsfehlern oder unerwartetem Verhalten.
  • JavaScript's Aufgrund der dem System eigenen Genauigkeitsbeschränkungen werden Gleitkommazahlen auf etwa 17 signifikante Stellen gekürzt. Zum Beispiel:
    • Eingabe: 0.123456789012345678901234567890
    • Verarbeiteter Wert: 0.12345678901234568

Benutzerschnittstellen werden in Microsoft Edge nicht unterstützt
Draft comment: garychapman
https://github.ibm.com/velox/ui/issues/12856
Draft comment: garychapman
*** REVIEWED BY SAVIO RODRIGUES ***
Die Benutzerschnittstellen von API Manager und Cloud Manager werden im Web-Browser Microsoft Edge nicht unterstützt. Verwenden Sie zum Arbeiten auf der Benutzerschnittstelle einen anderen Browser.