Menemukan dan menetapkan masa pemeliharaan

Halaman ini berisi prosedur untuk menemukan dan menetapkan masa pemeliharaan pada instance Cloud SQL. Untuk mempelajari lebih lanjut tentang cara dan alasan Cloud SQL melakukan pemeliharaan, lihat Ringkasan pemeliharaan pada instance Cloud SQL.

Sebelum memulai

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

  2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  4. Menginstal Google Cloud CLI.

  5. Untuk initialize gcloud CLI, jalankan perintah berikut: 

    gcloud init

  6. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  7. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  8. Menginstal Google Cloud CLI.

  9. Untuk initialize gcloud CLI, jalankan perintah berikut: 

    gcloud init

Menetapkan periode pilihan untuk pemeliharaan pada instance

Konsol

  1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan sebuah instance, klik nama instance.
  3. Di bagian Pemeliharaan, klik Edit preferensi pemeliharaan.
  4. Di bagian Opsi konfigurasi, buka Pemeliharaan.
  5. Konfigurasikan opsi berikut:
    • Periode pilihan. Tetapkan rentang hari dan jam saat update dapat dilakukan pada instance ini.
    • Urutan update. Tetapkan urutan update instance ini, terkait dengan update untuk instance lainnya. Tetapkan pengaturan waktu ke Any, Earlier, or Later. Instance yang menggunakan setelan Earlier menerima update hingga seminggu sebelum instance menggunakan setelan Later saat membandingkan instance yang berada di lokasi yang sama.

gcloud

Sebelum menggunakan perintah gcloud di bawah ini, buat pengganti berikut:

  • instance-id: Instance yang dijadwalkan ulang
  • day: Hari saat Anda ingin melakukan pemeliharaan. Tetapkan ke salah satu dari SUN, MON, TUE, WED, THU, FRI, SAT.
  • hour: Jam berlangsungnya masa pemeliharaan dalam zona waktu UTC (0-23).
gcloud sql instances patch instance-id \
--maintenance-window-day=day \
--maintenance-window-hour=hour
Untuk informasi referensi, lihat gcloud sql instances patch.

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

Jika Anda mengaktifkan notifikasi pemeliharaan, maka Cloud SQL akan mengirimkan notifikasi setelah instance sudah dijadwalkan untuk pemeliharaan, dengan tanggal dan waktu tepat saat pemeliharaan dijadwalkan untuk dilaksanakan. Cloud SQL akan mengirimkan notifikasi ini berdasarkan urutan masa pemeliharaan instance dari setelan update, sebagai berikut:

  • Jika urutan setelan update ditetapkan ke Earlier, maka Cloud SQL akan mengirimkan notifikasi pemeliharaan setidaknya satu minggu sebelumnya.
  • Jika urutan setelan update ditetapkan ke Later, maka Cloud SQL akan mengirimkan notifikasi pemeliharaan setidaknya dua minggu sebelumnya.

Mengaktifkan notifikasi pemeliharaan

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

  1. Buka halaman Komunikasi. Buka Komunikasi
  2. Di baris untuk Cloud SQL, Masa pemeliharaan, pilih tombol pilihan pada bagian Email untuk mengAKTIFkannya.

Setiap pengguna yang perlu menerima notifikasi harus mengaktifkannya secara terpisah.

Menemukan notifikasi pemeliharaan di konsol Google Cloud

Anda dapat melihat notifikasi pemeliharaan di beberapa tempat pada konsol Google Cloud:

  • Di dasbor AKTIVITAS, cari instance yang ditandai dengan Pemeliharaan SQL.
    Buka Aktivitas

  • Saat instance dijadwalkan untuk pemeliharaan, tanggal pemeliharaan tercantum pada halaman Instance di kolom Pemeliharaan. Kolom Pemeliharaan biasanya disembunyikan, tetapi otomatis ditampilkan saat pemeliharaan dijadwalkan. Anda juga dapat memilih Pemeliharaan dari Opsi tampilan kolom (Ikon opsi tampilan kolom berupa tiga baris) jika Anda ingin menu Pemeliharaan selalu muncul.

  • Selain itu, Anda dapat memilih instance untuk membuka halaman Detail instance. Jika instance dijadwalkan untuk pemeliharaan, Anda akan melihat pesan di panel Pemeliharaan.
    Buka instance Cloud SQL

Menemukan masa pemeliharaan terjadwal menggunakan API

gcloud

Sebelum menggunakan perintah gcloud di bawah ini, buat pengganti berikut

  • instance-id: Instance yang dijadwalkan ulang
gcloud sql instances describe instance-id

Cari bagian scheduledMaintenance dalam respons.

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
  • INSTANCE_NAME: nama instance yang Anda konfigurasi untuk ketersediaan tinggi

Metode HTTP dan URL: 

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}

Cari bagian scheduledMaintenance dalam respons.

REST v1beta4

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
  • INSTANCE_NAME: nama instance yang Anda konfigurasi untuk ketersediaan tinggi

Metode HTTP dan URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}

Cari bagian scheduledMaintenance dalam respons.

Menjadwalkan ulang pemeliharaan terencana

Anda dapat menjadwalkan ulang pemeliharaan menggunakan konsol Google Cloud, gcloud, atau Cloud SQL Admin API.

Konsol

  1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Filter istilah Pemeliharaan untuk menampilkan daftar semua instance yang dijadwalkan untuk pemeliharaan.
  3. Di kolom Pemeliharaan, klik Jadwalkan Ulang.
  4. Di dialog Jadwalkan Ulang, pilih apakah akan segera menerapkan pemeliharaan, menjadwalkan ulang pemeliharaan agar terjadi pada waktu tertentu dalam periode penundaan selama 28 hari, atau menunda ke periode pemeliharaan berikutnya yang tersedia.

gcloud

Sebelum menggunakan perintah gcloud di bawah ini, lakukan beberapa penggantian berikut:

  • instance-id: Instance yang dijadwalkan ulang
  • reschedule-type: Gunakan salah satu dari IMMEDIATE, NEXT_AVAILABLE_WINDOW, atau SPECIFIC_TIME.

    Jika memilih NEXT_AVAILABLE_WINDOW, pemeliharaan akan dijadwalkan ulang ke masa pemeliharaan berikutnya yang tersedia mengikuti waktu yang dijadwalkan saat ini.

  • reschedule-time: Jika memilih SPECIFIC_TIME untuk reschedule-type, Anda juga harus menetapkan flag ini guna menentukan hari dan waktu baru untuk melakukan pemeliharaan. Gunakan format ISO 8601. Misalnya, 2020-01-16T16:56:00.000Z
gcloud sql reschedule-maintenance instance-id \
--reschedule-type=reschedule-type \
[--schedule-time=reschedule-time]
Untuk informasi referensi, lihat gcloud sql reschedule-maintenance.

Jika Anda ingin menjadwalkan ulang pemeliharaan hingga 28 hari, periksa nomor versi gcloud. Jika nomor versinya di bawah 390.0.0_RC00, instal ulang gcloud.

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • project-id: ID project
  • instance-id: ID instance
  • reschedule-type: Gunakan salah satu dari IMMEDIATE, NEXT_AVAILABLE_WINDOW, atau SPECIFIC_TIME.

    Jika Anda memilih NEXT_AVAILABLE_WINDOW, pemeliharaan dijadwalkan ulang ke masa pemeliharaan berikutnya yang tersedia.

Metode HTTP dan URL: 

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/rescheduleMaintenance

Meminta isi JSON: 

{
  "reschedule": {
    "reschedule_type": "reschedule-type"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": RESCHEDULE_MAINTENANCE,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

Sebelum menggunakan salah satu dari data permintaan, lakukan penggantian berikut:

  • project-id: ID project
  • instance-id: ID instance
  • reschedule-type: Gunakan salah satu dari IMMEDIATE, NEXT_AVAILABLE_WINDOW, atau SPECIFIC_TIME.

    Jika Anda memilih NEXT_AVAILABLE_WINDOW, pemeliharaan dijadwalkan ulang ke masa pemeliharaan berikutnya yang tersedia.

Metode HTTP dan URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/rescheduleMaintenance

Meminta isi JSON: 

{
  "reschedule": {
    "reschedule_type": "reschedule-type"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": RESCHEDULE_MAINTENANCE,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Untuk melihat cara permintaan REST API yang mendasarinya dibuat untuk tugas ini, lihat APIs Explorer pada halaman instances:post.

Mengonfigurasi periode penolakan pemeliharaan

Anda dapat mengonfigurasi maksimum satu periode penolakan pemeliharaan instance Cloud SQL pada waktu tertentu. Periode penolakan pemeliharaan lebih diutamakan daripada masa pemeliharaan terjadwal. Jika ada konflik antara waktu masa pemeliharaan dan periode penolakan pemeliharaan, periode penolakan pemeliharaan akan menggantikan masa pemeliharaan.

Anda dapat menghapus periode penolakan pemeliharaan secara manual, baik saat sudah terjadi maupun belum terjadi.

Untuk mengonfigurasi periode penolakan pemeliharaan, tetapkan tanggal mulai, tanggal akhir, dan waktu saat interval dimulai dan berakhir. Periode penolakan pemeliharaan dapat berkisar dari satu hingga 90 hari.

Untuk tanggal mulai dan tanggal akhir, ada dua format:

  • yyyy-mm-dd: menunjukkan tanggal tertentu
  • mm-dd: menunjukkan tanggal yang berulang setiap tahun

Tanggal mulai dan tanggal akhir menggunakan zona waktu UTC. Untuk menetapkan zona waktu, gunakan kolom waktu untuk menyesuaikan waktu mulai. Misalnya, tanggal mulai = 2020-10-10 dan waktu = 07.00.00 menunjukkan waktu mulai 2020-10-10 07.00.00 UTC (2020-10-10 00.00.00 PST)

Untuk waktu, formatnya adalah: HH:mm:SS.

  • Jam memiliki rentang antara 0 dan 23 (inklusif).
  • Menit dan detik memiliki rentang antara 0 dan 59 (inklusif).

Konsol

  1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan sebuah instance, klik nama instance.
  3. Di bagian Pemeliharaan, klik Edit preferensi pemeliharaan.
  4. Di bagian Tolak periode pemeliharaan, tetapkan tanggal mulai dan akhir.
  5. Di bagian Opsi lanjutan, Anda juga dapat memilih Ulangi setiap tahun.
  6. Klik Save.

gcloud

Sebelum menggunakan perintah gcloud di bawah ini, buat pengganti berikut:

  • instance-id: id instance Cloud SQL
  • start-date: Tanggal saat interval dimulai. Misalnya, 2021-11-29
  • end-date: Tanggal saat interval berakhir. Misalnya, 2021-12-02
  • time: Waktu untuk memulai dan mengakhiri interval. Misalnya, 00.00.00
gcloud sql instances patch instance-id\
 --deny-maintenance-period-start-date=start-date \
 --deny-maintenance-period-end-date=end-date \
 --deny-maintenance-period-time=time

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • project-id: ID project
  • instance-id: ID instance
  • start-date: Tanggal mulai (tttt-bb-hh) atau (bb-hh) untuk pengulangan tahunan
  • end-date: Tanggal akhir (tttt-bb-hh) atau (bb-hh) untuk pengulangan tahunan
  • time: Waktu mulai dan berakhir (JJ.mm.DD)

Metode HTTP dan URL: 

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

Meminta isi JSON: 

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

Sebelum menggunakan salah satu dari data permintaan, lakukan penggantian berikut:

  • project-id: ID project
  • instance-id: ID instance
  • start-date: Tanggal mulai (tttt-bb-hh) atau (bb-hh) untuk pengulangan tahunan
  • end-date: Tanggal akhir (tttt-bb-hh) atau (bb-hh) untuk pengulangan tahunan
  • time: Waktu mulai dan berakhir (JJ.mm.DD)

Metode HTTP dan URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Meminta isi JSON: 

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Menghapus periode penolakan pemeliharaan

Konsol

  1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan sebuah instance, klik nama instance.
  3. Di bagian Pemeliharaan, klik Edit preferensi pemeliharaan.
  4. Di bagian Tolak periode pemeliharaan, klik Hapus.
  5. Klik Save.

gcloud

Sebelum menggunakan perintah gcloud di bawah ini, lakukan beberapa penggantian berikut:

  • instance-id: id instance Cloud SQL
gcloud sql instances patch instance-id \
--remove-deny-maintenance-period

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • project-id: ID project
  • instance-id: ID instance

Metode HTTP dan URL: 

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

Meminta isi JSON: 

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

Sebelum menggunakan salah satu dari data permintaan, lakukan penggantian berikut:

  • project-id: ID project
  • instance-id: ID instance

Metode HTTP dan URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Meminta isi JSON: 

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip seperti berikut ini:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Menolak notifikasi masa pemeliharaan

Notifikasi Masa Pemeliharaan tidak dikirim saat waktu pemeliharaan yang direncanakan berada dalam periode penolakan pemeliharaan dan dilarang oleh setelan periode penolakan pemeliharaan.

Jika Anda mengubah setelan periode penolakan pemeliharaan untuk mencegah pemeliharaan pada waktu yang telah dijadwalkan sebelumnya, instance Cloud SQL akan melewati pemeliharaan dan mengirimkan notifikasi tentang pembatalan pemeliharaan. Cloud SQL mengirimkan pemberitahuan pembatalan ini setiap kali instance dijadwalkan untuk update.

Notifikasi pemeliharaan terencana dikirim selama periode penolakan pemeliharaan dengan ketentuan bahwa pemeliharaan dijadwalkan di luar periode tersebut.

Langkah selanjutnya