REST-API anzeigen

Ein Cluster-Administrator kann die Red Hat® OpenShift® Container Platform (OCP)-Konsole verwenden, um URL für die Swagger-Benutzeroberfläche mit der WebSphere Automation REST API zu ermitteln.

Vorgehensweise

  1. Klicken Sie in der Konsole OpenShift Container Platform auf Networking > Routes.
  2. Um auf die Swagger-Benutzerschnittstelle zuzugreifen, befolgen Sie die Anweisungen für Ihre Version von WebSphere Automation.
    • Für WebSphere Automation 1.4.3 und höher:
      1. Suchen Sie auf der Seite Routes nach dem Eintrag cpd .
      2. Kopieren Sie URL in der Spalte "Ort ".
      3. Öffnen Sie eine neue Browserregisterkarte oder ein neues Browserfenster.
      4. Fügen Sie die URL, die Sie in Schritt 3 kopiert haben, in das Adressfeld des Browsers ein, hängen Sie einen der folgenden Pfade an die URL an und drücken Sie die Eingabetaste.
        • Hängen Sie für Core-APIs den folgenden Pfad an:
          /websphereauto/core/apis/openapi/ui/
        • Hängen Sie für Health-APIs den folgenden Pfad an:
          /websphereauto/health/apis/openapi/ui/
        • Hängen Sie für Sicherheits-APIs den folgenden Pfad an:
          /websphereauto/secvul/apis/openapi/ui/
    • Für WebSphere Automation 1.4.2 und früher:
      1. Suchen Sie auf der Seite Routen einen der folgenden Einträge.
        • Für die Sicherheit: wsa-secure-apis
        • Für den Status: wsa-healing-rest
      2. Klicken Sie auf die URL in der Spalte Location.

        Für diese URL wird ein leeres Browser-Fenster geöffnet.

      3. Klicken Sie auf das Adressfeld des Browsers, hängen Sie /openapi/ui an die vorhandene URL an und drücken Sie die Eingabetaste.
    Die Swagger-Benutzerschnittstelle wird im Browserfenster geöffnet.
  3. Klicken Sie auf Autorisieren.
    Der Dialog Available authorizations (Verfügbare Berechtigungen) wird geöffnet.
  4. Geben Sie im Textfeld Wert einen Tokenwert für ein berechtigtes Benutzerprofil ein.
    So erhalten Sie das Token:
    1. Geben Sie das Kennwort für das Administratorkonto an.
      oc -n WSA_INSTANCE_NAMESPACE get secret ibm-iam-bindinfo-platform-auth-idp-credentials -o jsonpath='{.data.admin_password}' | base64 -d && echo

      WSA_INSTANCE_NAMESPACE ist der Namensbereich der Instanz, auf der WebSphere Automation installiert ist. Wenn bei der Installation der Standardwert ausgewählt wurde, lautet der Wert websphere-automation.

    2. Ersetzen Sie <password> im folgenden Befehl durch den Wert, der vom Befehl im vorherigen Schritt zurückgegeben wurde, und verwenden Sie den korrekten Wert für WSA_INSTANCE_NAMESPACE.
      curl -k -X POST -H 'Content-Type: application/json' -d '{"username":"cpadmin","password":"<password>"}' https://$(oc get route -n WSA_INSTANCE_NAMESPACE -o jsonpath='{.items[?(@.spec.to.name=="ibm-nginx-svc")].spec.host}')/icp4d-api/v1/authorize | jq -r .token
    Weitere Informationen erhalten Sie bei Ihrem Clusteradministrator.

Ergebnisse

Nach der erfolgreichen Autorisierung mit einem gültigen Token können Sie die Swagger-Benutzerschnittstelle verwenden, um die WebSphere Automation -REST-API anzuzeigen.