Memperbarui jenis lingkungan Bayar sesuai penggunaan

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

Baca 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 kapan saja, dengan 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 Apigee Pay sesuai penggunaan dan penggunaan resource.

Peran dan izin yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna memperbarui jenis lingkungan Bayar sesuai penggunaan, minta administrator Anda 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 menggunakan API

Untuk memperbarui jenis lingkungan Bayar sesuai penggunaan yang ada, 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 Anda.
• ENV_NAME adalah nama lingkungan Apigee yang akan diupdate.
• 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 pada jenis lingkungan:

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

Perintah ini menampilkan environment resource object, 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 kemungkinan langkah 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	Menghapus satu atau beberapa lingkungan dari organisasi Anda.
Extensible proxy 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 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.