Memperbarui jenis lingkungan Bayar sesuai penggunaan

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

Lihat Apigee Edge dokumentasi.

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 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 dan mengelola penggunaan resource dan penagihan Bayar sesuai penggunaan Apigee Anda.

Peran dan izin yang diperlukan

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

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

Untuk mengetahui informasi selengkapnya tentang pemberian 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 Google Cloud konsol atau menggunakan API, seperti yang dijelaskan di bagian berikut.

Apigee di konsol Cloud

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

  1. Buka halaman Apigee di konsol.

    Buka Apigee

  2. Pilih project dengan organisasi dan lingkungan Bayar sesuai penggunaan yang ingin Anda perbarui.
  3. Pilih Management > Environments untuk membuka halaman daftar Environments.
  4. Di baris untuk lingkungan yang ingin Anda edit, klik Actions dan pilih Edit.
  5. Dalam 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 Environments.

Apigee API

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:

  • ORG_NAME adalah nama organisasi Bayar sesuai penggunaan Apigee Anda.
  • ENV_NAME adalah nama lingkungan Apigee yang akan diperbarui.
  • ENV_TYPE adalah jenis lingkungan yang diperbarui. Opsi yang tersedia 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 mencakup 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 langkah-langkah potensial yang dapat Anda lakukan untuk mengatasi masalah dan 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 di-deploy di lingkungan existing environment has an extensible API Batalkan deployment proxy yang dapat diperluas dari lingkungan.
Alur bersama 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 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.