Mengelola masa pemeliharaan instance Apigee

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Lihat dokumentasi Apigee Edge.

Bagian ini berisi prosedur untuk menemukan dan menetapkan masa pemeliharaan pada resource Apigee. Untuk mempelajari lebih lanjut cara dan alasan Apigee melakukan pemeliharaan, lihat Ringkasan pemeliharaan.

Menetapkan periode pilihan untuk pemeliharaan

Jika Anda membuat perubahan pada setelan masa pemeliharaan saat resource sedang menjalani pemeliharaan atau dijadwalkan untuk pemeliharaan, perubahan tersebut tidak akan langsung diterapkan. Perubahan ini akan diterapkan dalam tindakan pemeliharaan mendatang.

Jika Anda telah mengaktifkan notifikasi pemeliharaan, Apigee akan mengirimkan notifikasi setelah resource dijadwalkan untuk pemeliharaan, dengan tanggal dan waktu tepat saat pemeliharaan dijadwalkan untuk dilaksanakan. Apigee mengirimkan notifikasi ini berdasarkan urutan masa pemeliharaan resource dari setelan update Anda, sebagai berikut:

  • Jika urutan setelan update ditetapkan ke Minggu 1, maka Apigee akan mengirimkan notifikasi pemeliharaan setidaknya satu minggu sebelumnya.
  • Jika urutan setelan update ditetapkan ke Minggu 2, maka Apigee akan mengirimkan notifikasi pemeliharaan setidaknya dua minggu sebelumnya.

Anda hanya dapat menentukan satu periode pemeliharaan per instance Apigee. Permintaan dengan lebih dari satu masa pemeliharaan akan ditolak.

Jika ingin menyetel masa pemeliharaan untuk beberapa instance dalam organisasi yang sama, Anda harus memastikan ada jeda minimal 12 jam antara masa pemeliharaan untuk menghindari operasi pemeliharaan yang tumpang-tindih.

Saat memperbarui masa pemeliharaan, masa pemeliharaan sebelumnya akan ditimpa.

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -X PATCH \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "maintenanceUpdatePolicy": {
      "maintenanceWindows": [
        {
          "day": "SUNDAY",
          "startTime": {
            "hours": 23
          }
        }
      ],
      "maintenanceChannel": "WEEK1"
    }
  }' \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID?updateMask=maintenanceUpdatePolicy.maintenanceWindows,maintenanceUpdatePolicy.maintenanceChannel"

Dengan:

  • Pemeliharaan startTime dikonfigurasi dalam UTC.
  • ORGANIZATION_ID adalah ID organisasi Apigee Anda.
  • INSTANCE_ID adalah ID instance Apigee Anda.

Menemukan setelan pemeliharaan dan jadwal pemeliharaan yang ada

Anda dapat mengambil setelan pemeliharaan saat ini dan melihat pemeliharaan mendatang dengan memeriksa kolom maintenanceUpdatePolicy dan scheduledMaintenance, seperti yang ditunjukkan dalam contoh API berikut:

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -H "$AUTH" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID"

Dengan:

  • ORGANIZATION_ID adalah ID organisasi Apigee Anda.
  • INSTANCE_ID adalah ID instance Apigee Anda.

Contoh output

{
  ...
  "scheduledMaintenance": {
    "startTime": "2025-01-28T23:00:00Z"
  },
  "maintenanceUpdatePolicy": {
    "maintenanceWindows": [
      {
        "day": "SUNDAY",
        "startTime": {
          "hours": 23
        }
      }
    ]
  }
}

Menghapus setelan pemeliharaan

Jika tidak lagi memerlukan setelan pemeliharaan, Anda dapat menghapusnya dengan mengikuti petunjuk di bawah.

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -X PATCH \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "maintenanceUpdatePolicy": null
  }' \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID?updateMask=maintenanceUpdatePolicy"

Dengan:

  • ORGANIZATION_ID adalah ID organisasi Apigee Anda.
  • INSTANCE_ID adalah ID instance Apigee Anda.

Memilih untuk menerima notifikasi pemeliharaan

Sebelum mengaktifkan notifikasi pemeliharaan, Anda harus menetapkan periode pilihan untuk pemeliharaan pada resource.

  1. Di Google Cloud konsol, buka halaman Preferensi pengguna > Komunikasi.

    Buka Komunikasi

  2. Di baris untuk Apigee, Masa pemeliharaan, pilih tombol pilihan di bagian Email untuk mengAktifkannya.

Setiap pengguna yang perlu menerima notifikasi harus mengaktifkannya secara terpisah dengan mengikuti petunjuk di atas.