Melihat dan menetapkan masa pemeliharaan

MySQL   |  PostgreSQL   |  SQL Server

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

Jika Anda mengaktifkan notifikasi pemeliharaan, Cloud SQL akan mengirimkan notifikasi email saat update pemeliharaan tersedia untuk instance Cloud SQL Anda. Cloud SQL akan mengirimkan notifikasi sebelum peluncuran pemeliharaan, lalu melanjutkan untuk menerapkan update ke grup instance sesuai jadwal mingguan. Anda dapat mengontrol seberapa awal notifikasi yang Anda terima sebelum instance menerima update pemeliharaan dengan memilih waktu pemeliharaan untuk instance Anda.

Anda memiliki opsi berikut untuk menjadwalkan waktu update pemeliharaan:

• Jika Anda memilih Any atau tidak mengonfigurasi setelan ini, update pemeliharaan dapat terjadi kapan saja, tetapi biasanya terjadi dalam minggu pertama peluncuran.
• Jika Anda memilih Week 1 (juga disebut sebagai preview dan canary), update pemeliharaan akan dilakukan 7 hingga 14 hari setelah notifikasi pemeliharaan dikirim.
• Jika Anda memilih Week 2 (juga disebut sebagai production dan stable), update pemeliharaan akan dilakukan 15 hingga 21 hari setelah notifikasi dikirim.
• Jika Anda memilih Week 5, update pemeliharaan akan dilakukan 35 hingga 42 hari setelah notifikasi dikirim.

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.

Sebelum memulai

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. Install the gcloud CLI.

4. Configure the gcloud CLI to use your federated identity.

   For more information, see Sign in to the gcloud CLI with your federated identity.

5. To initialize the gcloud CLI, run the following command:

   gcloud init

Menetapkan masa 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:
   • Waktu pemeliharaan. Pilih minggu untuk menerapkan update pemeliharaan otomatis. Anda memiliki opsi berikut:
     • Any: update pemeliharaan dapat terjadi kapan saja, tetapi biasanya terjadi dalam Week 1.
     • Minggu 1: pemeliharaan terjadi 7 hingga 14 hari setelah notifikasi pemeliharaan dikirim.
     • Minggu 2: update pemeliharaan terjadi 15 hingga 21 hari setelah notifikasi dikirim.
     • Minggu ke-5: update pemeliharaan terjadi 35 hingga 42 hari setelah notifikasi dikirim.
   • Masa pemeliharaan. Pilih hari dan rentang waktu yang diinginkan. Opsi meliputi:
     • Setiap periode: masa pemeliharaan default. Update pemeliharaan tidak dibatasi pada hari atau waktu tertentu.
     • Hari dalam seminggu: pilih hari untuk masa pemeliharaan Anda Sabtu, Minggu, Senin, Selasa, Rabu, Kamis, atau Jumat.
     • Waktu: jika memilih hari, Anda juga dapat memilih waktu. Pilih interval satu jam di zona waktu lokal Anda.

gcloud

Untuk mengonfigurasi masa pemeliharaan dan waktu pemeliharaan pada instance Cloud SQL, jalankan perintah berikut:

gcloud sql instances patch INSTANCE_ID \
  --maintenance-window-day=DAY \
  --maintenance-window-hour=HOUR \
  --maintenance-release-channel=MAINTENANCE_TIMING
    

Ganti variabel berikut:

• INSTANCE_ID: ID instance, yang tidak boleh berupa instance replika baca.
• DAY: hari dalam seminggu saat Anda ingin melakukan pemeliharaan. Tetapkan ke MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, atau SUNDAY. Tentukan dalam zona waktu UTC.
• HOUR: jam dalam sehari, 0 - 23, untuk masa pemeliharaan. Tentukan dalam zona waktu UTC.
• MAINTENANCE_TIMING: minggu periode peluncuran pemeliharaan yang Anda inginkan untuk menerapkan update pemeliharaan. Opsi meliputi:
• preview: Ini berarti Minggu ke-1 setelah notifikasi pemeliharaan dikirim. Update pemeliharaan dijadwalkan antara 7 hingga 14 hari setelah notifikasi.
• production: Ini berarti Minggu ke-2 setelah notifikasi pemeliharaan dikirim. Update pemeliharaan dijadwalkan antara 15 hingga 21 hari setelah notifikasi.
• week5: Update pemeliharaan dijadwalkan 35 hingga 42 hari setelah notifikasi pemeliharaan dikirim.

Untuk informasi referensi, lihat gcloud sql instances patch.

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID atau nomor project dari project Google Cloud .
• INSTANCE_ID: ID instance, yang tidak boleh berupa instance replika baca.
• HOUR: jam dalam sehari, 0 - 23, untuk masa pemeliharaan. Tentukan dalam zona waktu UTC.
• DAY: hari dalam seminggu untuk melakukan update pemeliharaan. Tentukan MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, atau SUNDAY. Tentukan dalam zona waktu UTC.
• MAINTENANCE_TIMING: minggu periode peluncuran pemeliharaan yang Anda inginkan untuk menerapkan update pemeliharaan. Opsinya mencakup:
  • canary: Ini berarti Minggu ke-1 setelah notifikasi pemeliharaan dikirim. Update pemeliharaan dijadwalkan antara 7 hingga 14 hari setelah notifikasi.
  • stable: Ini berarti Minggu ke-2 setelah notifikasi pemeliharaan dikirim. Update pemeliharaan dijadwalkan antara 15 hingga 21 hari setelah pemberitahuan.
  • week5: Update pemeliharaan dijadwalkan 35 hingga 42 hari setelah notifikasi pemeliharaan dikirim.

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Meminta isi JSON:

{
  "settings": {
    "maintenanceWindow": {
        "hour": "HOUR",
        "day": "DAY",
        "updateTrack": "MAINTENANCE_TIMING"
    }
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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": "[e-mail]",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "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 data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID atau nomor project dari project Google Cloud .
• INSTANCE_ID: ID instance, yang tidak boleh berupa instance replika baca.
• HOUR: jam dalam sehari, 0 - 23, untuk masa pemeliharaan. Tentukan dalam zona waktu UTC.
• DAY: hari dalam seminggu saat Anda ingin update pemeliharaan dilakukan. Tentukan MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, atau SUNDAY. Tentukan dalam zona waktu UTC.
• MAINTENANCE_TIMING: minggu periode peluncuran pemeliharaan yang Anda inginkan untuk menerapkan update pemeliharaan. Opsinya mencakup:
  • canary: Ini berarti Minggu ke-1 setelah notifikasi pemeliharaan dikirim. Update pemeliharaan dijadwalkan antara 7 hingga 14 hari setelah notifikasi.
  • stable: Ini berarti Minggu ke-2 setelah notifikasi pemeliharaan dikirim. Update pemeliharaan dijadwalkan antara 15 hingga 21 hari setelah pemberitahuan.
  • week5: Update pemeliharaan dijadwalkan 35 hingga 42 hari setelah notifikasi pemeliharaan dikirim.

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Meminta isi JSON:

{
  "settings": {
    "maintenanceWindow": {
        "hour": "HOUR",
        "day": "DAY",
        "updateTrack": "MAINTENANCE_TIMING"
    }
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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": "[e-mail]",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Mengaktifkan notifikasi pemeliharaan

Sebelum mengaktifkan notifikasi pemeliharaan, Anda harus menetapkan masa 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 halaman Logs explorer di konsol Google Cloud . Gunakan menu drop-down All logs name untuk menelusuri maintenance-events, lalu klik Apply. Jika pemeliharaan dijadwalkan untuk sebuah instance, log akan menampilkan nama instance dan waktu mulai pemeliharaan terjadwalnya.

• 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 () 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 pemeliharaan terjadwal menggunakan API

gcloud

Untuk memeriksa pemeliharaan terjadwal mendatang, gunakan perintah berikut:

gcloud sql instances describe INSTANCE_ID
    

Ganti variabel berikut:

• INSTANCE_ID: Instance yang akan diperiksa untuk pemeliharaan terjadwal.

Dalam respons, cari bagian scheduledMaintenance.

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID atau nomor project dari 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 Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

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

Dalam respons, cari bagian scheduledMaintenance.

REST v1beta4

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID atau nomor project dari 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 Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

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

Dalam respons, cari bagian scheduledMaintenance.

Menjadwalkan ulang pemeliharaan terencana

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

Jika Anda menetapkan waktu pemeliharaan instance ke Minggu 1 atau Minggu 2, Anda dapat menjadwalkan ulang pemeliharaan hingga 28 hari.

Jika Anda menetapkan waktu pemeliharaan instance ke Minggu ke-5, Anda dapat menjadwalkan ulang pemeliharaan hingga 7 hari. Anda harus menjadwalkan ulang pemeliharaan dalam jangka waktu ini untuk memastikan bahwa instance menerima update pemeliharaan sebelum peluncuran pemeliharaan triwulanan berikutnya dimulai.

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 Reschedule, pilih apakah akan segera menerapkan pemeliharaan, menjadwalkan ulang pemeliharaan agar terjadi pada waktu tertentu dalam periode penundaan yang diizinkan seperti yang ditentukan dalam pemeliharaan terencana yang dijadwalkan ulang, atau menunda ke masa pemeliharaan berikutnya yang tersedia.

gcloud

Untuk menjadwalkan ulang pemeliharaan pada instance Cloud SQL, jalankan perintah berikut:

gcloud sql reschedule-maintenance INSTANCE_ID \
  --reschedule-type=RESCHEDULE_TYPE \
  [--schedule-time=RESCHEDULE_TIME]
  

Ganti variabel 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 Anda menentukan SPECIFIC_TIME untuk RESCHEDULE_TYPE, Anda juga harus menetapkan flag --schedule-time guna menentukan hari dan waktu baru untuk melakukan pemeliharaan. Gunakan format ISO 8601. Misalnya, 2020-01-16T16:56:00.000Z

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 data permintaan apa pun, lakukan penggantian berikut:

• PROJECT_ID: Project ID.
• INSTANCE_ID: ID instance.
• RESCHEDULE_TYPE: Jenis penjadwalan ulang. Gunakan salah satu dari IMMEDIATE, NEXT_AVAILABLE_WINDOW, atau SPECIFIC_TIME.

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

  Jika memilih SPECIFIC_TIME, Anda juga harus menyertakan schedule_time dalam isi permintaan.

• SCHEDULE_TIME: Jika Anda menentukan SPECIFIC_TIME untuk RESCHEDULE_TYPE, tentukan tanggal dan waktu untuk menjadwalkan ulang pemeliharaan dalam format RFC 3339. Sebagai contoh, 2026-11-07T04:00:00Z Jika Anda menentukan IMMEDIATE atau NEXT_AVAILABLE_WINDOW, hapus schedule_time dari isi permintaan.

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",
    "schedule_time": "SCHEDULE_TIME"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance" | Select-Object -Expand Content

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": "[e-mail]",
  "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 data permintaan apa pun, lakukan penggantian berikut:

• PROJECT_ID: Project ID.
• INSTANCE_ID: ID instance.
• RESCHEDULE_TYPE: Jenis penjadwalan ulang. Gunakan salah satu dari IMMEDIATE, NEXT_AVAILABLE_WINDOW, atau SPECIFIC_TIME.

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

  Jika memilih SPECIFIC_TIME, Anda juga harus menyertakan schedule_time dalam isi permintaan.

• SCHEDULE_TIME: Jika Anda menentukan SPECIFIC_TIME untuk RESCHEDULE_TYPE, tentukan tanggal dan waktu untuk menjadwalkan ulang pemeliharaan dalam format RFC 3339. Sebagai contoh, 2026-11-07T04:00:00Z Jika Anda menentukan IMMEDIATE atau NEXT_AVAILABLE_WINDOW, hapus schedule_time dari isi permintaan.

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",
    "schedule_time": "SCHEDULE_TIME"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance" | Select-Object -Expand Content

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": "[e-mail]",
  "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 di halaman instances:rescheduleMaintenance.

Catatan: Jika Anda menjadwalkan ulang pemeliharaan untuk instance pada saat yang sama dengan periode penolakan pemeliharaan yang ada, periode penolakan pemeliharaan akan lebih diutamakan dan peristiwa pemeliharaan akan dilewati.

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.

Perhatian: Mulai 15 Agustus 2025, Anda tidak dapat menetapkan periode penolakan pemeliharaan untuk instance jika versi pemeliharaannya lebih lama dari 12 bulan. Setiap instance yang menggunakan versi pemeliharaan yang lebih lama dari 12 bulan harus menerima update. Untuk mengupdate instance, lakukan pemeliharaan mandiri atau tunggu update otomatis selama masa pemeliharaan berikutnya. Setelah mengupdate instance, Anda dapat menetapkan periode penolakan 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 Periode menolak pemeliharaan, tetapkan tanggal mulai dan akhir.
5. Di bagian Opsi lanjutan, Anda juga dapat memilih Ulangi setiap tahun.
6. Klik Simpan.

gcloud

Untuk mengonfigurasi periode penolakan pemeliharaan pada instance Cloud SQL, jalankan perintah berikut:

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

Ganti variabel 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

REST v1

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

• project-id: Project ID
• 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:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id" | Select-Object -Expand Content

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": "[e-mail]",
  "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: Project ID
• 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:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

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": "[e-mail]",
  "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 Periode menolak pemeliharaan, klik Hapus.
5. Klik Simpan.

gcloud

Untuk menghapus periode penolakan pemeliharaan dari instance Cloud SQL, jalankan perintah berikut:

gcloud sql instances patch INSTANCE_ID \
--remove-deny-maintenance-period

Ganti variabel berikut:

• INSTANCE_ID: ID instance Cloud SQL

REST v1

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

• project-id: Project ID
• 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:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id" | Select-Object -Expand Content

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": "[e-mail]",
  "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: Project ID
• 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:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

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": "[e-mail]",
  "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 periode 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 berikutnya

• Memulai, menghentikan, dan memulai ulang instance
• Pelajari lebih lanjut periode penolakan pemeliharaan