Quando modifichi un proxy API, puoi decidere cosa fare con le modifiche risultanti:
Salva le modifiche sul server, ma non creare una nuova revisione. Esegui questa operazione quando non
vuoi eseguire il deployment delle modifiche salvate, ma vuoi solo assicurarti che non vadano perse se termini la
sessione.
OR
Crea una nuova revisione del proxy API e implementala nel cluster. Non puoi eseguire il deployment delle modifiche a un proxy API senza crearne una nuova revisione.
Apigee nella console Cloud
Per modificare un proxy API e salvare le modifiche utilizzando la console Apigee Cloud:
Nella console Google Cloud , vai alla pagina Sviluppo proxy > Proxy API.
Seleziona il proxy da modificare dall'elenco dei proxy.
L'interfaccia utente mostra la scheda Panoramica per quel proxy nella console Google Cloud .
Fai clic sulla scheda Sviluppo per apportare le modifiche al proxy.
Ad esempio, per aggiungere un criterio, fai clic sull'icona + accanto a Criteri,
seleziona il criterio da aggiungere, inserisci un nome e un nome visualizzato facoltativo, fai clic su Crea e
configura il criterio nell'interfaccia.
Al termine delle modifiche, puoi
eseguire una delle seguenti operazioni:
Per salvare le modifiche senza creare una nuova revisione, fai clic sul pulsante Salva. (Ti consigliamo di farlo
periodicamente per assicurarti che le modifiche non vadano perse se termini la sessione).
Per salvare le modifiche come nuova revisione (quando ti prepari per il deployment e il test),
fai clic sul menu a discesa accanto
al pulsante Salva e seleziona Salva come nuova revisione:
La UI di Apigee salva le modifiche e genera una nuova revisione del proxy. Non
esegue il deployment
del nuovo bundle nel runtime. Devi farlo esplicitamente, come descritto in
Deployment di un proxy API.
Apigee classico
Per modificare un proxy API e salvare le modifiche utilizzando l'editor proxy classico:
Fai clic su Proxy API nella visualizzazione principale.
In alternativa, puoi selezionare Sviluppa > Proxy API nel menu di navigazione a sinistra.
Seleziona l'ambiente che contiene il proxy che vuoi modificare.
L'UI di Apigee mostra un elenco di proxy API per l'ambiente selezionato:
Fai clic sul proxy che vuoi modificare. L'interfaccia utente mostra la scheda Panoramica per
il proxy nell'editor proxy:
Fai clic sulla scheda Sviluppa in alto a destra nella visualizzazione.
Utilizza l'editor proxy per apportare le modifiche al proxy. Al termine delle modifiche, puoi
eseguire una delle seguenti operazioni:
Salva le modifiche, ma non creare una nuova revisione (la più comune; dovresti farlo
periodicamente per assicurarti che le modifiche non vadano perse se termini la sessione).
Salva le modifiche come nuova revisione (quando ti prepari per il deployment e il test).
Per salvare senza creare una nuova revisione, fai clic su Salva
in alto a destra dell'interfaccia utente:
La UI di Apigee salva le modifiche in modo che tu possa uscire dalla pagina e riprendere a lavorare in un secondo momento.
Per salvare le modifiche come nuova revisione, fai clic sulla freccia menu a discesa accanto a
Salva e seleziona Salva come nuova revisione:
La UI di Apigee salva le modifiche e genera un nuovo bundle proxy. Non esegue il deployment
del nuovo bundle nel runtime. Devi farlo esplicitamente, come descritto in
Deployment di un proxy API.
L'interfaccia utente mostra il messaggio Nuova revisione salvata:
Dopo aver creato una nuova revisione, in genere la esegui il deployment nel cluster, come descritto in
Deployment di un proxy API.
API Apigee
Modifica un proxy API per creare una revisione nella tua organizzazione Apigee inviando una richiesta POST
alla seguente risorsa:
Devi definire il nome del proxy API utilizzando il parametro di query name. Limita
i caratteri utilizzati nel nome ai seguenti: A-Za-z0-9._\-$ %
(Facoltativo) Puoi importare un pacchetto di configurazione del proxy API seguendo questi passaggi:
Imposta il parametro di query action su import
Imposta l'intestazione Content-type su multipart/form-data
Trasmetti il nome del pacchetto di configurazione del proxy API sul file system locale
L'esempio seguente mostra come modificare un proxy API importando un bundle di configurazione del proxy API (helloworld-config.zip) nel file system locale utilizzando l'API.
Per saperne di più sulla modifica di un proxy API, consulta il metodo apis.create
nell'API Apigee. Per visualizzare tutti i metodi disponibili per i proxy API, consulta l'API proxy API.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-05 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)."]]
