Mengelola masa pemeliharaan instance Apigee

Halaman ini berlaku untuk Apigee, tetapi tidak untuk 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 resource sedang menjalani pemeliharaan atau memiliki acara pemeliharaan terjadwal, setiap perubahan yang Anda lakukan pada setelan masa pemeliharaan (termasuk mengubah hari/waktu, mengubah urutan update, atau menghapus setelan) tidak berlaku untuk acara yang tertunda. Pemeliharaan terjadwal akan dilanjutkan sesuai rencana, dan perubahan Anda hanya berlaku untuk peluncuran 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 setelan update masa pemeliharaan resource Anda, sebagai berikut:

Catatan: "Minggu 1" dan "Minggu 2" mengacu pada fase peluncuran dan waktu tunggu notifikasi (1 minggu versus 2 minggu). Laporan ini tidak merujuk pada minggu kalender pertama atau kedua dalam sebulan. Misalnya, peluncuran "Minggu 2" tidak harus terjadi pada minggu kedua dalam satu bulan kalender. Peluncuran ini terjadi satu minggu setelah peluncuran "Minggu 1" untuk rilis tertentu tersebut.

  • 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 masa 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.
  • maintenanceChannel: Setelan saluran pemeliharaan/urutan update (misalnya, WEEK1 atau WEEK2).
  • 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
        }
      }
    ],
    "maintenanceChannel": "WEEK1"
  }
}

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 konsol Google Cloud , 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.