Nachdem Sie Google Cloud und die Hybrid-Benutzeroberfläche konfiguriert und die Laufzeit installiert und konfiguriert haben, können Sie sehen, wie sie zusammenwirken.
In diesem Abschnitt werden folgende Schritte erläutert:
Wählen Sie in der Hauptansicht Develop > API Proxies aus.
Wählen Sie in der Drop-down-Liste Umgebung die Umgebung aus, in der Sie einen neuen API-Proxy erstellen möchten. In diesem Abschnitt wird der Name der Umgebung "test" verwendet. Sie haben in Schritt 5: Umgebung hinzufügen mindestens eine Umgebung erstellt.
Die Hybrid-Benutzeroberfläche zeigt eine Liste der API-Proxys für diese Umgebung an. Wenn Sie noch keine Proxys erstellt haben, ist die Liste leer.
Klicken Sie rechts oben auf +Proxy. Der API-Proxy-Assistent wird gestartet:
Wählen Sie Reverse Proxy (am häufigsten verwendet) aus und klicken Sie auf Weiter.
Die Ansicht Proxy-Details wird angezeigt.
Konfigurieren Sie den Proxy mit den folgenden Einstellungen:
Proxy Name: Geben Sie "myproxy" ein. In den verbleibenden Schritten in diesem Abschnitt wird davon ausgegangen, dass dies Ihre Proxy-ID ist.
Proxy-Basispfad: Wird automatisch auf "/myproxy" festgelegt. Der Proxy-Basispfad ist Teil der URL, die zum Senden von Anfragen an Ihre API verwendet wird. Edge verwendet die URL, um eingehende Anfragen zuzuordnen und an den richtigen API-Proxy weiterzuleiten.
(Optional) Beschreibung: Geben Sie eine Beschreibung für den neuen API-Proxy ein, z. B. "Apigee Hybrid mit einem einfachen Proxy testen".
Ziel (vorhandene API): Geben Sie "https://mocktarget.apigee.net" ein. Dies definiert die Ziel-URL, die Apigee für eine Anfrage an den API-Proxy aufruft. Der simulierte Zieldienst wird bei Apigee gehostet und gibt einfache Daten zurück. Ein API-Schlüssel oder ein Zugriffstoken sind nicht erforderlich.
Die Details Ihres API-Proxys sollten so aussehen:
Klicken Sie auf Weiter.
Wählen Sie auf dem Bildschirm Richtlinien die Sicherheitsoption Passthrough (keine Autorisierung) aus.
Klicken Sie auf Weiter.
Klicken Sie auf dem Bildschirm Zusammenfassung auf Erstellen.
Hybrid generiert den Proxy (manchmal auch als Proxy-Bundle bezeichnet):
Klicken Sie auf Zur Proxyliste.
Hybrid zeigt die Ansicht Proxys an, in der eine Liste der API-Proxys angezeigt wird. Der neue Proxy sollte sich oben in der Liste befinden und eine graue Statusanzeige aufweisen, was bedeutet, dass er noch nicht bereitgestellt wurde.
2. Proxy im Cluster über die Hybrid-Benutzeroberfläche bereitstellen
Nachdem Sie einen neuen Proxy erstellt haben, müssen Sie ihn bereitstellen, um es ausprobieren zu können. In diesem Abschnitt wird beschrieben, wie Sie Ihren neuen Proxy mithilfe der Hybrid-Benutzeroberfläche bereitstellen.
So stellen Sie einen API-Proxy in der Hybrid-Benutzeroberfläche bereit:
Wählen Sie in der Hybrid-Benutzeroberfläche Entwickeln > API Proxies.
Achten Sie darauf, dass die Testumgebung ausgewählt ist.
Der neue Proxy wird in der Benutzeroberfläche in der Liste der Proxys angezeigt:
Klicken Sie auf den Proxy "myproxy".
In der Benutzeroberfläche wird der Tab API-Proxies-Übersicht für diesen Proxy angezeigt.
Beachten Sie, dass unter Deployments in der Spalte Überarbeitung "Nicht bereitgestellt" angezeigt wird.
Maximieren Sie in der Spalte Revision die Drop-down-Auswahl, um die bereitzustellende Überarbeitung auszuwählen.
In der Drop-down-Liste werden nur "1" und "Bereitstellung aufheben" angezeigt.
Wählen Sie in der Drop-down-Liste die Überarbeitung aus, die Sie bereitstellen möchten.
Die Benutzeroberfläche fordert Sie auf, die Bereitstellung zu bestätigen:
Klicken Sie auf Deploy.
Die Benutzeroberfläche startet mit der Bereitstellung von Überarbeitung 1 Ihres neuen Proxys im Cluster.
Beachten Sie, dass die Bereitstellung kein sofortiger Prozess ist. Das "Eventual Consistency"-Bereitstellungsmodell von Hybrid bedeutet, dass eine neue Bereitstellung innerhalb eines kurzen Zeitraums für den Cluster bereitgestellt wird und nicht sofort.
Es gibt mehrere Möglichkeiten, den Bereitstellungsstatus eines Proxys in der Benutzeroberfläche zu prüfen. In den nächsten beiden Schritten wird erläutert, wie Sie den API-Proxy aufrufen, den Sie gerade bereit gestellt haben, und wie Sie den Bereitstellungsstatus mit einem Aufruf der Apigee APIs prüfen können.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-28 (UTC)."],[[["\u003cp\u003eThis documentation pertains to version 1.4 of the Apigee hybrid, which is end-of-life and requires an upgrade to a newer version for continued support.\u003c/p\u003e\n"],["\u003cp\u003eYou can create a new API proxy using the API Proxy Wizard in the Apigee UI, configuring settings like the proxy name, base path, description, and target API.\u003c/p\u003e\n"],["\u003cp\u003eAfter creating a new proxy, it must be deployed to the cluster using the hybrid UI by selecting the appropriate revision, although this deployment may not be immediate.\u003c/p\u003e\n"],["\u003cp\u003eOnce deployed, the API proxy can be tested by making a call to it using cURL or a similar tool, referencing the environment group's host alias.\u003c/p\u003e\n"],["\u003cp\u003eIf encountering TLS/SSL errors with a self-signed certificate, specific steps involving environment variables for the ingress host and port should be followed to successfully call the deployed API proxy.\u003c/p\u003e\n"]]],[],null,["# Create and deploy a new API proxy\n\n| You are currently viewing version 1.4 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nNow that you've configured and the hybrid UI, and installed and configured the\nruntime, you're ready to see how it all works together.\n\nThis section walks you through the following:\n\n1. **[Create a new API proxy](#create-proxy)** in the Apigee UI using the API Proxy Wizard\n2. **[Deploy your new proxy](#deploy)** to your cluster with the UI\n\n1. Create a new API proxy using the hybrid UI\n---------------------------------------------\n\nThis section describes how to create a new API proxy in the UI by using the API Proxy Wizard.\n\n**To create a simple API proxy using the API Proxy Wizard:**\n\n1. Open [Apigee UI](https://apigee.google.com) in a browser.\n2. Select **Develop \\\u003e API Proxies** in the main view.\n3. From the **Environment** drop-down list, select the environment in which you want to create a new API proxy. This section assumes the name of the environment is \"test\". You created at least one environment in [Step 5: Add an environment](/apigee/docs/hybrid/v1.4/precog-add-environment).\n\n The hybrid UI displays a list of API proxies for that environment. If you haven't created any\n proxies yet, the list is empty.\n4. Click **+Proxy** in the upper right. The API Proxy Wizard starts.\n5. Select **Reverse proxy** (most common), and click **Next** .\n\n The **Proxy details** view is displayed.\n6. Configure your proxy with the following settings:\n - **Proxy Name:** Enter \"myproxy\". The remaining steps in this section assume that this is your proxy's ID.\n - **Proxy Base Path:** Automatically set to \"/myproxy\". The **Proxy Base\n Path** is part of the URL used to make requests to your API. Edge uses the URL to match and route incoming requests to the proper API proxy.\n - (Optional)**Description:** Enter a description for your new API proxy, such as \"Testing Apigee hybrid with a simple proxy\".\n - **Target (Existing API):** Enter \"https://mocktarget.apigee.net\". This defines the target URL that Apigee invokes on a request to the API proxy. The mocktarget service is hosted at Apigee and returns simple data. It requires no API key or access token.\n\n Your API proxy's details should look like the following:\n\n7. Click **Next**.\n8. On the **Policies** screen, select **Pass through (no authorization)** as the security option.\n9. Click **Next**.\n10. On the **Summary** screen, click **Create** .\n\n Hybrid generates the proxy (sometimes referred to as *the proxy bundle*):\n\n | **NOTE:** In this case, the hybrid UI does *not* deploy the proxy to your cluster. You will do this in [the next step](#deploy).\n11. Click **Go to proxy list** .\n\n Hybrid displays the **Proxies** view, which displays a list of API proxies. The\n new proxy should be at the top of the list, with a gray status indicator, meaning that it has\n not yet been deployed.\n\n2. Deploy your proxy to the cluster using the hybrid UI\n-------------------------------------------------------\n\nAfter creating a new proxy, you must deploy it so that you can try it out. This section\ndescribes how to deploy your new proxy using the hybrid UI.\n\n**To deploy an API proxy in the hybrid UI:**\n\n1. In the hybrid UI, select **Develop \\\u003e API Proxies** .\n\n Be sure the \"test\" environment is selected.\n\n The UI displays your new proxy in the proxies list:\n\n2. Click on the \"myproxy\" proxy.\n\n The UI displays the **API Proxies Overview** tab for that proxy.\n\n Notice that under **Deployments** , the **Revision** column shows\n \"Not deployed\".\n3. In the **Revision** column, expand the drop-down selector to choose the revision to deploy.\n\n The drop down list displays only \"1\" and \"Undeploy\".\n4. Select \"1\"---the revision that you want to deploy---from the drop down list.\n\n The UI prompts you to confirm the deployment:\n\n5. Click **Deploy** .\n\n The UI begins the process of deploying revision 1 of your new proxy to the cluster.\n\n Note that deployment is not an instantaneous process. Hybrid's \"eventually consistent\"\n deployment model means that a new deployment will be rolled out to the cluster over a short\n period of time and not immediately.\n\nWhile there are [several ways](/apigee/docs/api-platform/deploy/ui-deploy-overview#viewing-deployment-status) to check the\ndeployment status of a proxy in the UI, the next two steps explain how to call the API proxy\nyou just deployed and how\nto check the deployment status with a call to the [Apigee APIs](/apigee/docs/reference/apis/apigee/rest).\n\n3. Call the API proxy\n---------------------\n\nWhen the [UI indicates\nyour proxy is deployed](/apigee/docs/api-platform/deploy/ui-deploy-overview#viewing-deployment-status), you can try calling it using cURL or the REST client of your choice.\nFor example:\n\n1. Export your environment group's host alias to a variable: \n\n ```\n $HOSTALIAS=your_host_alias\n ```\n2. Call the API proxy: \n\n ```\n curl -k https://$HOSTALIAS/myproxy\n ```\n\n\n For example: \n\n ```\n curl -v -k https://apitest.acme.com/myproxy\n ```\n\n If the call succeeds, you will see the following output: \n\n ```\n Hello, Guest!\n ```\n\n\nIf you used a self-signed certificate and you get a TLS/SSL error, try these steps instead:\n\n1. Export your environment group's host alias to a variable: \n\n ```\n $HOSTALIAS=your_host_alias\n ```\n2. Export the ingress host: \n\n ```\n export INGRESS_HOST=$(kubectl -n istio-system get service \\\n istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')\n ```\n3. Export the secure ingress port number: \n\n ```\n export SECURE_INGRESS_PORT=$(kubectl -n istio-system get \\\n service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name==\"https\")].port}')\n ```\n4. Call the API proxy: \n\n ```\n curl -H Host:$HOSTALIAS --resolve \\\n $HOSTALIAS:$SECURE_INGRESS_PORT:$INGRESS_HOST \\\n https://$HOSTALIAS:$SECURE_INGRESS_PORT/myproxy -k\n ```\n\n*[Google Cloud]: Google Cloud"]]
