Halaman ini diterjemahkan oleh Cloud Translation API.

Menemukan 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 tentang cara dan alasan Cloud SQL melakukan pemeliharaan, lihat Ringkasan pemeliharaan pada instance Cloud SQL.

Jika Anda telah mengaktifkan untuk menerima notifikasi pemeliharaan, maka Cloud SQL akan mengirimkan notifikasi email kepada Anda saat update pemeliharaan tersedia untuk instance Cloud SQL Anda. Cloud SQL akan mengirimkan notifikasi sebelum peluncuran pemeliharaan dan kemudian melanjutkan untuk menerapkan update ke grup instance berdasarkan jadwal mingguan. Anda dapat mengontrol seberapa awal notifikasi yang Anda terima sebelum instance Anda 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 terjadi 7 hingga 14 hari setelah notifikasi pemeliharaan dikirim.
Jika Anda memilih Week 2 (juga disebut sebagai production dan stable), update pemeliharaan akan terjadi 15 hingga 21 hari setelah notifikasi dikirim.
Jika Anda memilih Week 5, update pemeliharaan akan terjadi 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

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Install the gcloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Install the gcloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

Menetapkan masa pemeliharaan pada instance

Konsol

Di konsol Google Cloud , buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Untuk membuka halaman Ringkasan sebuah instance, klik nama instance.
Di bagian Pemeliharaan, klik Edit preferensi pemeliharaan.
Di bagian Opsi konfigurasi, buka Pemeliharaan.
Konfigurasikan opsi berikut:
- Waktu pemeliharaan. Pilih minggu untuk menerapkan update pemeliharaan otomatis. Anda memiliki opsi berikut:
  - Kapan Saja: update pemeliharaan dapat terjadi kapan saja, tetapi biasanya terjadi dalam Minggu 1.
  - Minggu 1: pemeliharaan dilakukan 7 hingga 14 hari setelah notifikasi pemeliharaan dikirim.
  - Minggu ke-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 dalam seminggu dan jangka waktu yang diinginkan. Opsi meliputi:
  - Jendela apa pun: masa pemeliharaan default. Pembaruan pemeliharaan tidak dibatasi pada hari tertentu dalam seminggu atau waktu tertentu dalam sehari.
  - Hari dalam seminggu: pilih hari untuk masa pemeliharaan Anda Sabtu, Minggu, Senin, Selasa, Rabu, Kamis, atau Jumat.
  - Waktu: jika Anda memilih hari dalam seminggu, Anda juga dapat memilih waktu. Pilih interval satu jam dalam zona waktu lokal Anda.

gcloud

Untuk mengonfigurasi periode 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 dapat berupa instance replika baca.
DAY: hari dalam seminggu saat Anda ingin melakukan pemeliharaan. Tetapkan ke MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, atau SUNDAY. Tentukan di zona waktu UTC.
HOUR: jam dalam sehari, 0 - 23, untuk masa pemeliharaan. Tentukan di zona waktu UTC.
MAINTENANCE_TIMING: minggu periode peluncuran pemeliharaan yang Anda inginkan untuk penerapan update pemeliharaan. Opsi meliputi:

preview: Ini berarti Minggu 1 setelah notifikasi pemeliharaan dikirim. Update pemeliharaan dijadwalkan antara 7 hingga 14 hari setelah notifikasi.
production: Ini berarti Minggu 2 setelah pemberitahuan 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 Google Cloud project.
INSTANCE_ID: ID instance, yang tidak boleh berupa instance replika baca.
HOUR: jam dalam sehari, 0 - 23, untuk masa pemeliharaan. Tentukan di zona waktu UTC.
DAY: hari dalam seminggu saat update pemeliharaan akan terjadi. Tentukan MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, atau SUNDAY. Tentukan di zona waktu UTC.
MAINTENANCE_TIMING: minggu periode peluncuran pemeliharaan yang Anda inginkan untuk penerapan update pemeliharaan. Opsinya mencakup:
- canary: Ini berarti Minggu 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 notifikasi.
- 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": "user@example.com",
  "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 Google Cloud project.
INSTANCE_ID: ID instance, yang tidak boleh berupa instance replika baca.
HOUR: jam dalam sehari, 0 - 23, untuk masa pemeliharaan. Tentukan di zona waktu UTC.
DAY: hari dalam seminggu saat Anda ingin pembaruan pemeliharaan terjadi. Tentukan MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, atau SUNDAY. Tentukan di zona waktu UTC.
MAINTENANCE_TIMING: minggu periode peluncuran pemeliharaan yang Anda inginkan untuk penerapan update pemeliharaan. Opsinya mencakup:
- canary: Ini berarti Minggu 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 notifikasi.
- 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)

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)

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": "user@example.com",
  "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

Buka halaman Komunikasi. Buka Komunikasi
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 drop-down All logs name untuk menelusuri maintenance-events, lalu klik Apply. Jika pemeliharaan dijadwalkan untuk instance, maka 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 mengetahui apakah ada 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, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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)

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": "MYSQL_8_0"
}

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, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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)

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": "MYSQL_8_0"
}

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 menyetel waktu pemeliharaan instance ke Minggu 1 atau Minggu 2, Anda dapat menjadwalkan ulang pemeliharaan hingga 28 hari.

Jika Anda menyetel 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 instance menerima update pemeliharaan sebelum peluncuran pemeliharaan kuartalan berikutnya dimulai.

Konsol

Di konsol Google Cloud , buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Filter istilah Pemeliharaan untuk menampilkan daftar semua instance yang dijadwalkan untuk pemeliharaan.
Di kolom Pemeliharaan, klik Jadwalkan Ulang.
Di dialog Jadwalkan Ulang, pilih apakah akan segera menerapkan pemeliharaan, menjadwalkan ulang pemeliharaan agar terjadi pada waktu tertentu dalam periode penundaan yang diizinkan sebagaimana ditentukan dalam pemeliharaan terencana yang dijadwalkan ulang, atau menunda ke periode 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 tanda --schedule-time untuk 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 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 akan 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:

curl (Linux, macOS, atau Cloud Shell)

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)

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": "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 akan 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:

curl (Linux, macOS, atau Cloud Shell)

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)

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 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": 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: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

Di konsol Google Cloud , buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Untuk membuka halaman Ringkasan sebuah instance, klik nama instance.
Di bagian Pemeliharaan, klik Edit preferensi pemeliharaan.
Di bagian Tolak periode pemeliharaan, tetapkan tanggal mulai dan akhir.
Di bagian Opsi lanjutan, Anda juga dapat memilih Ulangi setiap tahun.
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: 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:

curl (Linux, macOS, atau Cloud Shell)

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)

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": "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:

curl (Linux, macOS, atau Cloud Shell)

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)

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": "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

Di konsol Google Cloud , buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Untuk membuka halaman Ringkasan sebuah instance, klik nama instance.
Di bagian Pemeliharaan, klik Edit preferensi pemeliharaan.
Di bagian Tolak periode pemeliharaan, klik Hapus.
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: 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:

curl (Linux, macOS, atau Cloud Shell)

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)

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": "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:

curl (Linux, macOS, atau Cloud Shell)

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)

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": "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.

Menemukan dan menetapkan masa pemeliharaan Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Menetapkan masa pemeliharaan pada instance

Konsol

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Mengaktifkan notifikasi pemeliharaan

Menemukan notifikasi pemeliharaan di konsol Google Cloud

Menemukan pemeliharaan terjadwal menggunakan API

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Menjadwalkan ulang pemeliharaan terencana

Konsol

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Mengonfigurasi periode penolakan pemeliharaan

Konsol

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Menghapus periode penolakan pemeliharaan

Konsol

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Menolak notifikasi masa pemeliharaan

Langkah berikutnya

Menemukan dan menetapkan masa pemeliharaan