Memperbarui jenis lingkungan Bayar sesuai penggunaan

Halaman ini berlaku untuk Apigee, tetapi tidak untuk Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Atribut harga Bayar sesuai penggunaan Apigee didasarkan sebagian pada jenis lingkungan yang Anda kaitkan ke instance Apigee. Anda dapat memilih untuk menambahkan lingkungan Dasar, Menengah, atau Komprehensif ke organisasi Bayar sesuai penggunaan kapan saja, serta menyesuaikan skema harga berdasarkan kebutuhan fitur dan kapasitas Anda. Topik ini menjelaskan cara mengupgrade atau mendowngrade jenis lingkungan yang sudah ada untuk menambahkan atau menghapus kemampuan fitur dan mengelola penagihan dan penggunaan resource Apigee Pay-as-you-go.

Peran dan izin yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk memperbarui jenis lingkungan Bayar sesuai penggunaan, minta administrator untuk memberi Anda peran IAM berikut pada project:

  • Admin Organisasi Apigee (apigee.organization.admin)
  • Admin Lingkungan Apigee (apigee.environment.admin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Memperbarui jenis lingkungan Anda

Anda dapat memperbarui jenis lingkungan Bayar sesuai penggunaan yang ada menggunakan UI Apigee di Konsol Google Cloud atau menggunakan API, seperti yang dijelaskan di bagian berikut.

Apigee di Konsol Cloud

Untuk mengupdate jenis lingkungan Bayar sesuai penggunaan yang ada menggunakan UI Apigee di konsol Google Cloud:

  1. Buka halaman Apigee di konsol.

    Buka Apigee

  2. Pilih project dengan organisasi Bayar sesuai penggunaan dan lingkungan yang ingin Anda perbarui.
  3. Pilih Management > Environments untuk membuka halaman daftar Environments.
  4. Di baris untuk lingkungan yang ingin Anda edit, klik Actions , lalu pilih Edit.
  5. Di dialog Edit lingkungan, pilih salah satu opsi di bagian Pilih jenis lingkungan.
  6. Klik Update untuk menyimpan perubahan.
  7. Untuk mengonfirmasi perubahan jenis lingkungan, muat ulang halaman daftar Lingkungan.

API Apigee

Untuk memperbarui jenis lingkungan Bayar sesuai penggunaan yang ada menggunakan Apigee API, gunakan perintah berikut: 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME?updateMask=type" \
          -H "Authorization: Bearer $token" \
          -X PATCH \
          -H 'Content-Type: application/json' \
          -d '{"type":"ENV_TYPE"}'

Dengan keterangan:

  • ORG_NAME adalah nama organisasi Apigee Bayar sesuai penggunaan.
  • ENV_NAME adalah nama lingkungan Apigee yang akan diupdate.
  • ENV_TYPE adalah jenis lingkungan yang diupdate. Opsinya adalah BASE, INTERMEDIATE, atau COMPREHENSIVE.

Misalnya, untuk mengupgrade lingkungan Dasar bernama test-env ke Komprehensif, gunakan perintah berikut: 

curl "https://apigee.googleapis.com/v1/organizations/my-org/environments/test-env?updateMask=type" \
          -H "Authorization: Bearer $token" \
          -X PATCH \
          -H 'Content-Type: application/json' \
          -d '{"type":"COMPREHENSIVE"}'

Setelah operasi selesai, gunakan perintah berikut untuk mengonfirmasi perubahan jenis lingkungan: 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME" -H "Authorization: Bearer $token"

Perintah ini menampilkan objek resource lingkungan, yang menyertakan jenis lingkungan yang dipilih.

Referensi error

Saat mengupgrade atau mendowngrade jenis lingkungan, operasi akan gagal jika lingkungan yang ada berisi resource yang tidak kompatibel dengan jenis lingkungan yang baru dipilih. Untuk informasi selengkapnya tentang fitur yang tersedia dan batasan menurut jenis lingkungan, lihat Perbandingan jenis lingkungan.

Jika operasi gagal, Anda akan melihat error dengan format berikut: 

  {
    "error": {
      "code": "FAILED_PRECONDITION",
      "message": "environment type update invalid: ...<detailed message here >... :failed precondition",
      "status": "FAILED_PRECONDITION"
      }
  }

Tabel berikut meringkas kemungkinan pesan error dan langkah potensial yang dapat Anda lakukan untuk mengatasi masalah tersebut serta mengupgrade atau mendowngrade jenis lingkungan:

Kondisi kegagalan Pesan error Langkah-langkah penyelesaian
Jumlah maksimum lingkungan per organisasi terlampaui cannot transfer active environments to INTERMEDIATE, will exceed limit

cannot transfer active environments to BASE, will exceed limit

 Hapus satu atau beberapa lingkungan dari organisasi Anda.
Proxy yang dapat diperluas yang di-deploy di lingkungan existing environment has an extensible API Batalkan deployment proxy yang dapat diperluas dari lingkungan.
Alur bersama yang di-deploy di lingkungan existing environment has a shared flow Batalkan deployment alur bersama dari lingkungan.
Jumlah maksimum unit deployment proxy per lingkungan per region pdu count, 50, cannot exceed 20

pdu count, 425, cannot exceed 50

 Batalkan deployment dan hapus alur bersama atau proxy dari lingkungan.
Add-on yang diaktifkan di lingkungan Existing environment has an addon enabled Nonaktifkan add-on di lingkungan.
Dukungan multi-region diaktifkan di lingkungan instance attachment count, 2, cannot exceed 1 for BASE environment

instance attachment count, 2, cannot exceed 1 for INTERMEDIATE environment

 Hapus lampiran instance kedua untuk lingkungan.