Sie heben die Bereitstellung einer API-Proxy-Überarbeitung aus Ihrem Cluster wie in den folgenden Abschnitten beschrieben auf.
Beachten Sie beim Aufheben der Bereitstellung einer Überarbeitung Folgendes:
Apigee führt das Rollback der Überarbeitung nicht auf die zuvor bereitgestellte Überarbeitung aus.
Nach dem Aufheben der Bereitstellung werden in der Umgebung keine Überarbeitungen des API-Proxys mehr bereitgestellt.
Das Aufheben der Bereitstellung eines API-Proxys ähnelt dem Löschen eines API-Proxys, mit dem Unterschied, dass Sie die Bereitstellung während der Aufhebung einer Überarbeitung in der Benutzeroberfläche ändern und später noch einmal bereitstellen können. Wenn Sie den API-Proxy löschen, kann er nicht mehr bearbeitet werden.
Neuer Proxy-Editor
So heben Sie die Bereitstellung eines API-Proxys über die Benutzeroberfläche auf:
Auf der UI wird eine Liste der aktuellen API-Proxys für die ausgewählte Umgebung angezeigt:
Wählen Sie den API-Proxy aus, dessen Bereitstellung Sie aufheben möchten.
Auf der UI wird die Ansicht Overview des API-Proxys angezeigt.
Erweitern Sie in der gewünschten Zeile der Umgebung die Drop-down-Liste Revision und wählen Sie Undeploy aus.
Sie werden in der Benutzeroberfläche aufgefordert, die Version zu bestätigen, deren Bereitstellung Sie aufheben möchten:
Klicken Sie auf Undeploy.
Der Status wird von der UI aktualisiert. Damit wird angezeigt, dass die Überarbeitung sofort aus dem Cluster entfernt wurde:
Die Aufhebung der Bereitstellung kann jedoch einige Zeit dauern (im Modell Eventual Consistency). Wenn Sie auf Bereitstellung aufheben klicken, beginnt Apigee damit, die Bereitstellung der ausgewählten Überarbeitung aus dieser Umgebung im Cluster aufzuheben.
Weitere Informationen zur Statusprüfung des Proxys, dessen Bereitstellung aufgehoben wurde, finden Sie unter Bereitstellungsstatus ansehen.
Alternativ können Sie die Bereitstellung der aktuellen Überarbeitung, die Sie bearbeiten, im Tab Develop aufheben:
Klicken Sie auf die Drop-down-Liste Bereitstellen auf: env_name:
Auf der UI wird eine Liste der Umgebungen angezeigt. In der Spalte Überarbeitung wird von der UI die aktuell bereitgestellte Überarbeitung (oder &emdash;, wenn keine vorhanden ist) aufgelistet. Es werden die Schaltflächen Bereitstellenrevision und Bereitstellung aufheben angezeigt.
Klicken Sie für die gewünschte Umgebung auf die Schaltfläche Bereitstellung aufheben.
Sie werden in der Benutzeroberfläche aufgefordert, die Version zu bestätigen, deren Bereitstellung Sie aufheben möchten:
Klicken Sie auf die Schaltfläche Undeploy.
Der Status wird von der UI aktualisiert. Damit wird angezeigt, dass die Bereitstellung der Überarbeitung sofort aufgehoben wurde. Die Aufhebung der Bereitstellung kann jedoch einige Zeit dauern (im Modell Eventual Consistency). Wenn Sie auf Bereitstellung aufheben klicken, beginnt Apigee damit, die Bereitstellung der ausgewählten Überarbeitung aus dieser Umgebung aufzuheben.
Apigee API
Verwenden Sie folgenden API-Aufruf, um die Bereitstellung eines API-Proxys aufzuheben:
In folgenden Abschnitten finden Sie Beispiele zur Verwendung von gcloud alpha apigee-CLI-Befehlen, um die Bereitstellung von API-Proxy-Überarbeitungen aufzuheben und die Aufhebung der Bereitstellungen zu validieren.
[[["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 page explains how to undeploy API proxy revisions in Apigee and Apigee hybrid environments, which is similar to deleting an API proxy but allows for future editing and redeployment.\u003c/p\u003e\n"],["\u003cp\u003eUndeploying a revision means no revisions of the API proxy will be deployed in the environment, and Apigee does not roll the revision back to a previous version.\u003c/p\u003e\n"],["\u003cp\u003eThe undeployment process can be initiated through the Apigee UI's new or classic Proxy Editor, as well as via the Apigee API using a \u003ccode\u003ecurl\u003c/code\u003e command or the \u003ccode\u003egcloud\u003c/code\u003e CLI.\u003c/p\u003e\n"],["\u003cp\u003eAfter initiating the undeploy process, Apigee begins the process of removing the revision from the environment, but it may take some time to complete due to the eventually consistent model.\u003c/p\u003e\n"],["\u003cp\u003eYou can validate the success of the undeployment by checking the deployment status in the Apigee UI or by using the \u003ccode\u003egcloud\u003c/code\u003e CLI to list deployments and confirm that no revisions are present.\u003c/p\u003e\n"]]],[],null,["# Undeploying an API proxy\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| **Note:** To undeploy API proxies in environments enabled for [archive deployments](/apigee/docs/api-platform/fundamentals/environments-overview#deployment-types), see [Deploying and managing\n| archives in an Apigee environment](/apigee/docs/api-platform/deploy/manage-archive-deployments).\n\nUndeploy an API proxy revision from your cluster as described in the following sections.\n\nNote that when you undeploy a revision:\n\n- Apigee does not roll the revision back to the previously deployed revision.\n- After undeploying, no revisions of the API proxy are deployed in the environment.\n\nUndeploying an API proxy is similar to [deleting an API proxy](/apigee/docs/api-platform/develop/ui-delete-proxy), except\nthat when you undeploy a revision you can choose to edit it in the UI and later re-deploy it. If you\n*delete* the API proxy, it is no longer available to edit. \n\n### Apigee in Cloud console\n\nTo undeploy an API proxy using the UI:\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 API proxy that you want to undeploy.\n The UI displays the API proxy's **Overview** view.\n\n3. In the **Deployments** section, click **Undeploy**.\n\n4. In the **Undeploy** dialog, click **Confirm**.\n\n### Classic UI\n\nTo undeploy an API proxy using the UI:\n\n1. Sign in to the [Apigee UI](https://apigee.google.com).\n2. Select **Develop \\\u003e API Proxies** .\n\n The UI displays a list of current API proxies for the selected environment:\n\n3. Select the API proxy that you want to undeploy.\n\n The UI displays the API proxy's **Overview** view.\n4. In the desired environment row, expand the **Revision** drop-down list and select **Undeploy** :\n\n The UI prompts you to confirm the version you want to undeploy:\n\n5. Click **Undeploy** .\n\n The UI updates the status to show that the revision was undeployed from the cluster\n immediately:\n\n Note, though, that the undeployment process can take some time (in the *eventually\n consistent* model). In fact, when you click **Undeploy** , Apigee *begins*\n the process of undeploying the selected revision from that environment in the cluster.\n\n For information on how to check the status of the undeployed proxy, see\n [Viewing deployment status](/apigee/docs/api-platform/deploy/ui-deploy-overview#viewing-deployment-status).\n\nAlternatively, you can undeploy the current revision that you are editing in the\n**Develop** tab:\n\n1. Click the **Deploy to: *env_name*** drop-down list:\n\n The UI displays a list of environments. In the **Revision** column, the UI lists\n the currently deployed revision (or **---** if none), and prompts you with **Deploy\n \u003cvar translate=\"no\"\u003erevision\u003c/var\u003e** and **Undeploy** buttons.\n2. Click the **Undeploy** button for the desired environment.\n\n The UI prompts you to confirm the version you want to undeploy:\n\n3. Click the **Undeploy** button.\n\n The UI updates the status to show that the revision was undeployed immediately. However,\n the undeployment process can take some time (in the *eventually consistent* model). When you\n click **Undeploy**, Apigee begins the process of undeploying the selected\n revision from that environment.\n\n### Apigee API\n\nTo undeploy an API proxy, use the following API call: \n\n```\ncurl \"https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/revisions/$REV/deployments\" \\\n -X DELETE \\\n -H \"Authorization: Bearer $TOKEN\"\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 (an empty response): \n\n```\n{}\n```\n\nFor more information, see the [Undeploy API proxy revision API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.environments.apis.revisions.deployments/undeploy).\n\n### gcloud\n\n\nThe following sections provide examples of using `gcloud alpha apigee` CLI commands to\nundeploy API proxy revisions and validate the undeployment.\n\n- [Undeploying an API proxy revision using the gcloud CLI](#undeploy-api-revision-cli)\n- [Validating the undeployment of an API proxy revision using the gcloud CLI](#validate-undeployment-cli)\n\n\nFor more information and a description of the environment variables used in the examples,\nsee [Getting started using gcloud with Apigee](/apigee/docs/api-platform/get-started/gcloud-get-started).\n\n#### Undeploying an API proxy revision using the gcloud CLI\n\n\nTo undeploy an API proxy revision, use the following gcloud command: \n\n```\ngcloud alpha apigee apis undeploy $REV --api=$API --environment=$ENV\n```\n\n\nThe following provides an example of the response: \n\n```\nUsing Apigee organization `my-org`\n```\n\n#### Validating the undeployment of an API proxy revision using the gcloud CLI\n\n\nTo validate that the API proxy revision has been undeployed from the environment, use the following gcloud command: \n\n```\ngcloud alpha apigee deployments list --api=$API --environment=$ENV\n```\n\n\nThe following provides an example of the response: \n\n```\nUsing Apigee organization `my-org`\nListed 0 items.\n```\n\n\nFor more information, see [List deployments CLI](/sdk/gcloud/reference/alpha/apigee/deployments/list)."]]
![Drop-down für die Bereitstellung, mit der Sie die aktuelle Überarbeitungen für Umgebungen bereitstellen oder deren Bereitstellung aufheben können](https://cloud.google.com/static/apigee/docs/api-platform/images/ui-devtab-deploy.png?authuser=0000&hl=de "Drop-down "Bereitstellung"")