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

Peran dan izin yang diperlukan

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

  • Apigee Organization Admin (apigee.organization.admin)
  • Apigee Environment Admin (apigee.environment.admin)

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

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

Memperbarui jenis lingkungan

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.

Konsol Apigee di CloudApigee API

Untuk memperbarui 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 dan lingkungan Bayar sesuai penggunaan yang ingin Anda perbarui.
  3. Pilih Pengelolaan > Lingkungan untuk membuka halaman daftar Lingkungan.
  4. Pada baris untuk lingkungan yang ingin diedit, klik Actions , lalu pilih Edit.
  5. Pada dialog Edit environment, pilih opsi di bagian Select environment type.
  6. Klik Update untuk menyimpan perubahan.
  7. Untuk mengonfirmasi perubahan jenis lingkungan, muat ulang halaman daftar Lingkungan.

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 Pay-as-you-go Anda.
  • ENV_NAME adalah nama lingkungan Apigee yang akan diperbarui.
  • ENV_TYPE adalah jenis lingkungan yang diperbarui. Opsinya adalah BASE, INTERMEDIATE, atau COMPREHENSIVE.

Misalnya, untuk mengupgrade lingkungan Base bernama test-env ke Comprehensive, 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 mengetahui informasi selengkapnya tentang fitur dan batasan yang tersedia 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 merangkum kemungkinan pesan error dan potensi langkah yang dapat Anda lakukan untuk menyelesaikan masalah dan mengupgrade atau mendowngrade jenis lingkungan:

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

cannot transfer active environments to BASE, will exceed limit

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