Verwenden Sie die Apigee-Benutzeroberfläche oder API, um einen API-Proxy zu bearbeiten. Beim Bearbeiten eines API-Proxys können Sie entscheiden, was mit den resultierenden Änderungen geschehen soll:
Speichern Sie die Änderungen auf dem Server, erstellen Sie jedoch keine neue Überarbeitung. Dies geschieht, wenn Sie Ihre gespeicherten Änderungen nicht bereitstellen möchten, aber einfach verhindern möchten, dass sie verloren gehen.
OR
Eine neue API-Proxy-Revision erstellen und im Cluster bereitstellen Sie können keine Änderungen an einem API-Proxy vornehmen, ohne eine neue Version erstellen zu müssen.
Neuer Proxy-Editor
So bearbeiten Sie mit dem neuen Proxy-Editor einen API-Proxy und speichern Ihre Änderungen:
Wenn Sie die klassischeApigee-UI verwenden: Wählen Sie Entwickeln > API-Proxys aus und im Bereich Proxys wählen Sie die Umgebung für den Proxy aus.
Wählen Sie den zu bearbeitenden Proxy aus der Liste der Proxys aus.
In der UI wird der Tab Übersicht für diesen Proxy im Proxy-Editor angezeigt.
Klicken Sie auf den Tab Entwickeln.
Verwenden Sie den Proxy-Editor, um Änderungen am Proxy vorzunehmen. Wenn Sie die Änderungen vorgenommen haben, können Sie einen der folgenden Schritte ausführen:
Klicken Sie auf die Schaltfläche Speichern, um Ihre Änderungen zu speichern, aber keine neue Überarbeitung zu erstellen. Sie sollten dies regelmäßig tun, um sicherzustellen, dass Ihre Änderungen nicht verloren gehen, wenn Sie die Sitzung beenden.
Klicken Sie auf das Drop-down-Menü neben der Schaltfläche Speichern und wählen Sie Als neue Überarbeitung speichern, um Ihre Änderungen als neue Überarbeitung zu speichern:
Die Apigee-UI speichert Ihre Änderungen und generiert eine neue Überarbeitung des Proxys für Sie. Das neue Bundle wird nicht in der Laufzeit bereitgestellt. Sie müssen dies explizit tun, wie unter API-Proxy bereitstellen beschrieben.
Klassischer Proxy-Editor
So bearbeiten Sie mit dem klassischen Proxy-Editor einen API-Proxy und speichern Ihre Änderungen:
Alternativ können Sie im linken Navigationsmenü die Option Entwickeln auswählen.
Wählen Sie die Umgebung aus, die den Proxy enthält, den Sie bearbeiten möchten.
In der Apigee-Benutzeroberfläche wird eine Liste der API-Proxys für die ausgewählte Umgebung angezeigt:
Klicken Sie auf den Proxy, den Sie bearbeiten möchten. In der UI wird der Tab Übersicht für diesen Proxy im Proxy-Editor angezeigt:
Klicken Sie oben rechts in der Ansicht auf den Tab Entwickeln.
Verwenden Sie den Proxy-Editor, um Änderungen am Proxy vorzunehmen. Wenn Sie die Änderungen vorgenommen haben, können Sie einen der folgenden Schritte ausführen:
Speichern Sie Ihre Änderungen, erstellen Sie aber keine neue Überarbeitung (häufig verwendet). Sie sollten dies regelmäßig tun, um sicherzustellen, dass Ihre Änderungen nicht verloren gehen, wenn Sie die Sitzung beenden.
Speichern Sie die Änderungen als neue Überarbeitung, wenn Sie für die Bereitstellung und den Test bereit sind.
Um zu speichern, aber keine neue Überarbeitung zu erstellen, klicken Sie oben rechts in der Benutzeroberfläche auf Speichern:
Die Apigee-UI speichert Ihre Änderungen, damit Sie die Seite verlassen und später weiterarbeiten können.
So speichern Sie Ihre Änderungen als neue Überarbeitung: Klicken Sie auf den Drop-down-Pfeil neben der Schaltfläche Speichern und wählen Sie Als neue Überarbeitung speichern aus:
Die Apigee-UI speichert Ihre Änderungen und generiert ein neues Proxy-Bundle für Sie. Das neue Bundle wird nicht in der Laufzeit bereitgestellt. Sie müssen dies explizit tun, wie unter API-Proxy bereitstellen beschrieben.
In der UI wird die Meldung Neue Überarbeitung gespeichert angezeigt:
Nachdem Sie eine neue Überarbeitung erstellt haben, stellen Sie diese normalerweise in Ihrem Cluster bereit, wie unter API-Proxy bereitstellen erläutert.
Apigee API
Bearbeiten Sie einen API-Proxy, um eine Überarbeitung in Ihrer Apigee-Organisation zu erstellen. Senden Sie dazu eine POST-Anfrage an die folgende Ressource:
Sie müssen den Namen des API-Proxys mit dem Abfrageparameter name definieren. Die im Namen verwendeten Zeichen sollten auf folgende begrenzt sein: A-Za-z0-9._\-$ %
Optional können Sie ein API-Proxy-Konfigurationsset mit den folgenden Schritten importieren:
Setzen Sie den Abfrageparameter action auf import.
Setzen Sie den Content-type-Header auf multipart/form-data.
Übergeben Sie den Namen des API-Proxy-Konfigurationssets auf Ihrem lokalen Dateisystem.
Das folgende Beispiel zeigt, wie Sie einen API-Proxy erstellen, indem Sie mithilfe der API ein API-Proxy-Konfigurations-Bundle (helloworld-config.zip) in Ihr lokales Dateisystem importieren.
Weitere Informationen zum Erstellen eines API-Proxys finden Sie in der Apigee API unter der Methode apis.create. Alle für API-Proxys verfügbaren Methoden finden Sie unter API Proxies API.
[[["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-09-04 (UTC)."],[[["\u003cp\u003eThis guide provides instructions on how to edit API proxies within Apigee and Apigee hybrid environments, offering methods through the Apigee UI and API.\u003c/p\u003e\n"],["\u003cp\u003eWhen editing an API proxy, you can save changes without creating a new revision or save changes as a new revision, which is necessary for deployment.\u003c/p\u003e\n"],["\u003cp\u003eThe guide details the use of both the new and classic Proxy Editors within the Apigee UI, showing how to access and utilize each interface.\u003c/p\u003e\n"],["\u003cp\u003eEditing via the Apigee API involves sending a POST request to a specific URL, with the option to import an API proxy configuration bundle.\u003c/p\u003e\n"],["\u003cp\u003eDeploying a new revision of an API proxy after saving it is a separate step, requiring explicit action as outlined in the "Deploying an API proxy" documentation.\u003c/p\u003e\n"]]],[],null,["# Editing an API proxy (create a proxy revision)\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\n| **More Information** \n|\n| For more information, see:\n|\n| - [Best practices for API proxy design and development](/apigee/docs/api-platform/fundamentals/best-practices-api-proxy-design-and-development)\n\nUse the Apigee UI or API to edit an API proxy. Editing an API proxy can include configuring\n[policies](/apigee/docs/api-platform/reference/policies/reference-overview-policy),\nconfiguring\n[proxy endpoints](/apigee/docs/api-platform/fundamentals/understanding-routes#determiningtheurloftheapiproxyendpoint),\n[target endpoints](/apigee/docs/api-platform/fundamentals/understanding-routes#determiningtheurlofthetargetendpoint), and\n[integration endpoints](/apigee/docs/api-platform/integration/getting-started-apigee-target-endpoint),\nadding or removing\n[flow hooks](/apigee/docs/api-platform/fundamentals/flow-hooks), and\n[deploying the proxy](/apigee/docs/api-platform/deploy/ui-deploy-new).\n\nWhen you edit an API proxy, you can decide which\nof the following to do with the resulting changes:\n\n1. Save your changes on the server but do not create a new revision. You do this when you do not want to deploy your saved changes, but just want to ensure that they are not lost if you end the session. \n\n **OR**\n2. Create a new API proxy revision and deploy it to the cluster. You cannot deploy changes to an API proxy without creating a new revision of it.\n\n### Apigee in Cloud console\n\nTo edit an API proxy and save your changes using the Apigee Cloud console:\n\n1. In the Google Cloud console, go to the **Proxy development \\\u003e API proxies** page.\n\n [Go to API proxies](https://console.cloud.google.com/apigee/proxies)\n2. Select the proxy that you want to edit from the list of proxies.\n The UI displays the **Overview** tab for that proxy in the Google Cloud console.\n\n3. Click the **Develop** tab to make your changes to the proxy. \n\n For example, to add a policy, click the **+** icon next to **Policies** , select the policy to add, enter a name and an optional display name, click **Create** , and configure the policy in the interface. \n4. When you are done making changes, you can do one of the following:\n - To save your changes but *not* create a new revision, click the **Save** button. (You should do this periodically to ensure that your changes are not lost if you end the session).\n - To save your changes as a new revision (when you are getting ready to deploy and test), click the drop-down menu next to the **Save** button and select **Save as new revision** :\n\n The Apigee UI saves your changes and generates a new revision of the proxy for you. It\n does not deploy\n the new bundle to the runtime; you must explicitly do that, as described in\n [Deploying an API proxy](/apigee/docs/api-platform/deploy/ui-deploy-new).\n\n### Classic Apigee\n\nTo edit an API proxy and save your changes using the classic Proxy Editor:\n\n1. Sign in to the [Apigee UI](https://apigee.google.com).\n2. Click **API Proxies** in the main view.\n\n Alternatively, you can select **Develop \\\u003e API Proxies** in the left navigation\n menu.\n3. Select the environment that contains the proxy you want to edit.\n\n The Apigee UI displays a list of API proxies for the selected environment:\n\n4. Click the proxy that you want to edit. The UI displays the **Overview** tab for that proxy in the Proxy Editor:\n\n5. Click the **Develop** tab in the upper right of the view.\n6. Use the proxy editor to make your changes to the proxy. When you are done making changes, you can do one of the following:\n - Save your changes but do not create a new revision (most common; you should do this periodically to ensure that your changes are not lost if you end the session).\n - Save your changes as a new revision (when you are getting ready to deploy and test).\n7. To save but *not* create a new revision, click **Save** in the upper right of the UI:\n\n The Apigee UI saves your changes so that you can leave the page and resume working later.\n8. To save your changes as a new revision, click the drop-down arrow next to **Save** and select **Save as new revision** :\n\n The Apigee UI saves your changes and generates a new proxy bundle for you. It does not deploy\n the new bundle to the runtime; you must explicitly do that, as described in\n [Deploying an API proxy](/apigee/docs/api-platform/deploy/ui-deploy-new).\n\n The UI displays a **New revision saved** message:\n\n After you create a new revision, you typically deploy it to your cluster, as described in\n [Deploying an API proxy](/apigee/docs/api-platform/deploy/ui-deploy-new).\n\n### Apigee API\n\nEdit an API proxy to create a revision in your Apigee organization by issuing a `POST`\nrequest to the following resource: \n\n```\nhttps://apigee.googleapis.com/v1/organizations/$ORG/apis\n```\n\nYou must define the name of the API proxy using the `name` query parameter. Restrict\nthe characters used in the name to the following: `A-Za-z0-9._\\-$ %`\n\nOptionally, you can import an API proxy configuration bundle by performing the following steps:\n\n- Set the `action` query parameter to `import`\n- Set the `Content-type` header to `multipart/form-data`\n- Pass the name of the API proxy configuration bundle on your local file system\n\nThe following example demonstrates how to edit an API proxy by importing an API proxy\nconfiguration bundle (`helloworld-config.zip`) on your local file system using the\nAPI. \n\n```\nexport TOKEN=$(gcloud auth print-access-token)\nexport ORG=ORGANIZATION_NAME\ncurl \"https://apigee.googleapis.com/v1/organizations/$ORG/apis?name=helloworld&action=import\" \\\n -X POST \\\n -H \"Authorization: Bearer $TOKEN\" \\\n -H \"Content-type: multipart/form-data\" \\\n -F \"file=@helloworld-config.zip\"\n```\n\nWhere `$TOKEN` is set to your OAuth 2.0 access token, as described in\n[Obtaining an OAuth 2.0 access token](/apigee/docs/api-platform/get-started/api-get-started#oauth20). For information about the `curl` options used in this example, see\n[Using curl](/apigee/docs/api-platform/get-started/api-get-started#curl). For a description of environment variables you can use, see\n[Setting\nenvironment variables for Apigee API requests](/apigee/docs/api-platform/get-started/api-get-started#api-environment-variables).\n\nThe following provides an example of the response output: \n\n```carbon\n{\n \"basepaths\": [\n \"/helloworld\"\n ],\n \"configurationVersion\": {\n \"majorVersion\": 4\n },\n \"createdAt\": \"1559145292799\",\n \"displayName\": \"helloworld\",\n \"entityMetaDataAsProperties\": {\n \"bundle_type\": \"zip\",\n \"subType\": \"Proxy\",\n \"lastModifiedAt\": \"1559145292799\",\n \"createdAt\": \"1559145292799\"\n },\n \"lastModifiedAt\": \"1559145292799\",\n \"name\": \"helloworld\",\n \"policies\": [\n \"verify-api-key\",\n \"remove-query-param-apikey\",\n \"OAuth-v20-1\"\n ],\n \"proxies\": [\n \"default\"\n ],\n \"proxyEndpoints\": [\n \"default\"\n ],\n \"resourceFiles\": {},\n \"targetEndpoints\": [\n \"default\"\n ],\n \"targets\": [\n \"default\"\n ],\n \"type\": \"Application\",\n \"revision\": \"1\",\n \"description\": \"Hello world\"\n}\n```\n\nFor more information on editing an API proxy, see the [`apis.create` method](/apigee/docs/reference/apis/apigee/rest/v1/organizations.apis/create)\nin the Apigee API. To see all the methods available for API proxies, see the [API proxies API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.apis)."]]
