Mengedit proxy API (membuat revisi proxy)

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Gunakan UI atau API Apigee untuk mengedit proxy API. Mengedit proxy API dapat mencakup konfigurasi kebijakan, konfigurasi endpoint proxy, endpoint target, dan endpoint integrasi, penambahan atau penghapusan flow hook, dan deployment proxy.

Saat mengedit proxy API, Anda dapat memutuskan tindakan berikut yang akan dilakukan dengan perubahan yang dihasilkan:

  1. 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

  2. Buat revisi proxy API baru dan deploy ke cluster. Anda tidak dapat men-deploy perubahan ke proxy API tanpa membuat revisi barunya.

UI Apigee

Untuk mengedit proxy API dan menyimpan perubahan menggunakan UI Apigee:

  1. Di konsol Google Cloud , buka halaman Apigee > Proxy development > API proxies.

    Buka proxy API

  2. Pilih proxy yang ingin Anda edit dari daftar proxy. UI menampilkan tab Overview untuk proxy tersebut di konsol Google Cloud .

    Tab Overview di Editor Proxy
  3. Klik tab Develop untuk melakukan perubahan pada proxy.

    Misalnya, untuk menambahkan kebijakan, klik ikon + di samping Policies, pilih kebijakan yang akan ditambahkan, masukkan nama dan nama tampilan opsional, klik Create, dan konfigurasi kebijakan di antarmuka.
    Menambahkan kebijakan menggunakan UI
  4. 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 dan pilih Simpan sebagai revisi baru:

      Simpan perubahan sebagai revisi baru di menu Simpan.

      UI Apigee menyimpan perubahan Anda dan membuat revisi baru proxy untuk Anda. Bundle baru tidak di-deploy ke runtime; Anda harus melakukannya secara eksplisit, seperti yang dijelaskan dalam Men-deploy proxy API.

API Apigee

Edit proxy API untuk membuat revisi di organisasi Apigee Anda dengan mengeluarkan permintaan POST ke resource berikut:

https://apigee.googleapis.com/v1/organizations/$ORG/apis

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 Anda menggunakan API.

export TOKEN=$(gcloud auth print-access-token)
export ORG=ORGANIZATION_NAME
curl "https://apigee.googleapis.com/v1/organizations/$ORG/apis?name=helloworld&action=import" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: multipart/form-data" \
  -F "file=@helloworld-config.zip"

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0 Anda, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk mengetahui deskripsi variabel lingkungan yang dapat Anda gunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Berikut adalah contoh output respons:

{
  "basepaths": [
    "/helloworld"
  ],
  "configurationVersion": {
    "majorVersion": 4
  },
  "createdAt": "1559145292799",
  "displayName": "helloworld",
  "entityMetaDataAsProperties": {
    "bundle_type": "zip",
    "subType": "Proxy",
    "lastModifiedAt": "1559145292799",
    "createdAt": "1559145292799"
  },
  "lastModifiedAt": "1559145292799",
  "name": "helloworld",
  "policies": [
    "verify-api-key",
    "remove-query-param-apikey",
    "OAuth-v20-1"
  ],
  "proxies": [
    "default"
  ],
  "proxyEndpoints": [
    "default"
  ],
  "resourceFiles": {},
  "targetEndpoints": [
    "default"
  ],
  "targets": [
    "default"
  ],
  "type": "Application",
  "revision": "1",
  "description": "Hello world"
}

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.