Saat mengedit proxy API, Anda dapat memutuskan tindakan yang akan dilakukan terhadap perubahan yang dihasilkan:
Simpan perubahan Anda di server, tetapi jangan membuat revisi baru. Anda melakukan tindakan ini jika Anda tidak ingin men-deploy perubahan yang disimpan, tetapi hanya ingin memastikan bahwa perubahan tersebut tidak hilang jika Anda mengakhiri sesi.
ATAU
Buat revisi proxy API baru dan deploy ke cluster. Anda tidak dapat men-deploy perubahan pada
proxy API tanpa membuat revisi barunya.
Apigee di Konsol Cloud
Untuk mengedit proxy API dan menyimpan perubahan menggunakan konsol Apigee Cloud:
Di konsol Google Cloud , buka halaman Proxy development > API proxies.
Pilih proxy yang ingin Anda edit dari daftar proxy.
UI menampilkan tab Overview untuk proxy tersebut di konsol Google Cloud .
Klik tab Develop untuk melakukan perubahan pada proxy.
Misalnya, untuk menambahkan kebijakan, klik ikon + di samping Kebijakan,
pilih kebijakan yang akan ditambahkan, masukkan nama dan nama tampilan opsional, klik Buat, dan
konfigurasi kebijakan di antarmuka.
Setelah selesai melakukan perubahan, Anda
dapat melakukan salah satu hal berikut:
Untuk menyimpan perubahan Anda, tetapi tidak membuat revisi baru, klik tombol Simpan. (Anda harus melakukannya secara berkala untuk memastikan perubahan Anda tidak hilang jika Anda mengakhiri sesi).
Untuk menyimpan perubahan sebagai revisi baru (saat Anda bersiap untuk men-deploy dan menguji),
klik menu drop-down di samping
tombol Simpan, lalu pilih Simpan sebagai revisi baru:
UI Apigee menyimpan perubahan Anda dan membuat revisi baru proxy untuk Anda. Bundle
tidak di-deploy
ke runtime; Anda harus melakukannya secara eksplisit, seperti yang dijelaskan dalam
Men-deploy proxy API.
Apigee Klasik
Untuk mengedit proxy API dan menyimpan perubahan menggunakan Editor Proxy klasik:
Atau, Anda dapat memilih Develop > API Proxies di menu navigasi
sebelah kiri.
Pilih lingkungan yang berisi proxy yang ingin Anda edit.
UI Apigee menampilkan daftar proxy API untuk lingkungan yang dipilih:
Klik proxy yang ingin Anda edit. UI menampilkan tab Ringkasan untuk
proxy tersebut di Editor Proxy:
Klik tab Develop di kanan atas tampilan.
Gunakan editor proxy untuk membuat perubahan pada proxy. Setelah selesai melakukan perubahan, Anda
dapat melakukan salah satu hal berikut:
Simpan perubahan Anda, tetapi jangan membuat revisi baru (paling umum; Anda harus melakukannya secara berkala untuk memastikan perubahan Anda tidak hilang jika Anda mengakhiri sesi).
Simpan perubahan Anda sebagai revisi baru (saat Anda bersiap untuk men-deploy dan menguji).
Untuk menyimpan tetapi tidak membuat revisi baru, klik Simpan
di kanan atas UI:
UI Apigee menyimpan perubahan Anda sehingga Anda dapat keluar dari halaman dan melanjutkan pekerjaan nanti.
Untuk menyimpan perubahan sebagai revisi baru, klik panah drop-down di samping
Simpan, lalu pilih Simpan sebagai revisi baru:
UI Apigee akan menyimpan perubahan Anda dan membuat paket proxy baru untuk Anda. Bundle baru tidak di-deploy ke runtime; Anda harus melakukannya secara eksplisit, seperti yang dijelaskan dalam Men-deploy proxy API.
UI menampilkan pesan Revisi baru disimpan:
Setelah membuat revisi baru, Anda biasanya men-deploy-nya ke cluster, seperti yang dijelaskan dalam
Men-deploy proxy API.
Apigee API
Edit proxy API untuk membuat revisi di organisasi Apigee Anda dengan mengeluarkan permintaan POST
ke resource berikut:
Anda harus menentukan nama proxy API menggunakan parameter kueri name. Batasi
karakter yang digunakan dalam nama hanya untuk karakter berikut: A-Za-z0-9._\-$ %
Secara opsional, Anda dapat mengimpor paket konfigurasi proxy API dengan melakukan langkah-langkah berikut:
Tetapkan parameter kueri action ke import
Tetapkan header Content-type ke multipart/form-data
Teruskan nama paket konfigurasi proxy API di sistem file lokal Anda
Contoh berikut menunjukkan cara mengedit proxy API dengan mengimpor paket konfigurasi proxy API (helloworld-config.zip) di sistem file lokal menggunakan API.
Untuk mengetahui informasi selengkapnya tentang cara mengedit proxy API, lihat metode apis.create
di Apigee API. Untuk melihat semua metode yang tersedia untuk proxy API, lihat API proxy API.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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)."]]
