Mengelola pencadangan standar

Halaman ini menjelaskan cara mengelola pencadangan untuk instance Anda yang menggunakan opsi pencadangan standar. Hal ini mencakup cara menjadwalkan dan menonaktifkan pencadangan otomatis, membuat dan mengelola pencadangan on-demand, serta melihat pencadangan untuk instance Cloud SQL Anda. Jika instance Anda menggunakan pencadangan yang disempurnakan, lihat Mengelola pencadangan yang disempurnakan.

Untuk mengetahui informasi selengkapnya tentang cara kerja pencadangan, lihat Ringkasan pencadangan Cloud SQL. Untuk mengetahui informasi selengkapnya tentang opsi pencadangan yang tersedia untuk instance Cloud SQL Anda, lihat artikel Memilih opsi pencadangan.

Membuat Pencadangan Sesuai Permintaan

Untuk membuat cadangan on-demand:

Konsol

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

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Pilih Cadangan dari menu navigasi SQL.
  4. Klik Buat cadangan.
  5. Di halaman Buat cadangan, tambahkan deskripsi, jika perlu, lalu klik Create.

gcloud

Membuat cadangan:

gcloud sql backups create \
--async \
--instance=INSTANCE_NAME

Anda dapat menyediakan deskripsi cadangan menggunakan --description parameter.

Untuk membuat cadangan di lokasi kustom:

gcloud sql backups create \
--async \
--instance=INSTANCE_NAME \
--location=BACKUP_LOCATION

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/backupRuns

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

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/backupRuns

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Mengonfigurasi pencadangan otomatis

Pencadangan otomatis dilakukan dengan irama jadwal saat instance Anda berjalan. Anda juga dapat menetapkan periode retensi untuk cadangan otomatis Anda. Untuk mengetahui informasi selengkapnya tentang cara kerja pencadangan otomatis, lihat Pencadangan otomatis.

Menjadwalkan pencadangan otomatis

Untuk menjadwalkan pencadangan otomatis untuk sebuah instance:

Konsol

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

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Pilih Cadangan dari menu navigasi SQL.
  4. Klik Edit, di samping Setelan.
  5. Pilih periode waktu untuk mencadangkan data Anda secara otomatis.
  6. Klik Simpan.

gcloud

  1. Edit instance untuk menentukan waktu mulai pencadangan: 
    gcloud sql instances patch INSTANCE_NAME --backup-start-time=HH:MM
     Parameter backup-start-time ditentukan dalam format waktu 24 jam dalam zona waktu UTC±00, dan menentukan awal periode pencadangan 4 jam. Pencadangan dapat dimulai kapan saja selama periode pencadangan.
  2. Konfirmasi perubahan Anda: 
    gcloud sql instances describe INSTANCE_NAME
     Di bagian backupConfiguration, konfirmasi bahwa Anda melihat enabled: true dan waktu yang Anda tentukan.

Terraform

Untuk membuat pencadangan untuk database, gunakan resource Terraform. 

resource "google_sql_database_instance" "default" {
  name             = "sqlserver-instance-backup"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled    = true
      start_time = "20:55"
    }
  }
}

Menerapkan perubahan

Untuk menerapkan konfigurasi Terraform di project Google Cloud , selesaikan langkah-langkah di bagian berikut.

Menyiapkan Cloud Shell

  1. Luncurkan Cloud Shell.

  2. Tetapkan project Google Cloud default tempat Anda ingin menerapkan konfigurasi Terraform.

    Anda hanya perlu menjalankan perintah ini sekali per project, dan dapat dijalankan di direktori mana pun.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Variabel lingkungan akan diganti jika Anda menetapkan nilai eksplisit dalam file konfigurasi Terraform.

Menyiapkan direktori

Setiap file konfigurasi Terraform harus memiliki direktorinya sendiri (juga disebut modul root).

  1. Di Cloud Shell, buat direktori dan file baru di dalam direktori tersebut. Nama file harus memiliki ekstensi .tf—misalnya main.tf. Dalam tutorial ini, file ini disebut sebagai main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Jika mengikuti tutorial, Anda dapat menyalin kode contoh di setiap bagian atau langkah.

    Salin kode contoh ke dalam main.tf yang baru dibuat.

    Atau, salin kode dari GitHub. Tindakan ini direkomendasikan jika cuplikan Terraform adalah bagian dari solusi menyeluruh.

  3. Tinjau dan ubah contoh parameter untuk diterapkan pada lingkungan Anda.
  4. Simpan perubahan Anda.
  5. Lakukan inisialisasi Terraform. Anda hanya perlu melakukan ini sekali per direktori. 
    terraform init

    Secara opsional, untuk menggunakan versi penyedia Google terbaru, sertakan opsi -upgrade: 

    terraform init -upgrade

Menerapkan perubahan

  1. Tinjau konfigurasi dan pastikan resource yang akan dibuat atau diupdate oleh Terraform sesuai yang Anda inginkan: 
    terraform plan

    Koreksi konfigurasi jika diperlukan.

  2. Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt: 
    terraform apply

    Tunggu hingga Terraform menampilkan pesan "Apply complete!".

  3. Buka Google Cloud project Anda untuk melihat hasilnya. Di konsol Google Cloud , buka resource Anda di UI untuk memastikan bahwa Terraform telah membuat atau mengupdatenya.

Menghapus perubahan

Untuk menghapus perubahan Anda, lakukan langkah-langkah berikut:

  1. Untuk menonaktifkan perlindungan penghapusan, di file konfigurasi Terraform Anda, tetapkan argumen deletion_protection ke false. 
    deletion_protection =  "false"
  2. Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt: 
    terraform apply

  1. Hapus resource yang sebelumnya diterapkan dengan konfigurasi Terraform Anda dengan menjalankan perintah berikut dan memasukkan yes pada prompt:

    terraform destroy

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 replika baca atau utama yang Anda konfigurasi untuk ketersediaan tinggi
  • START_TIME: waktu (dalam jam dan menit)

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

REST v1beta4

Menetapkan retensi cadangan otomatis

Untuk menetapkan jumlah cadangan otomatis yang akan dipertahankan:

Konsol

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

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Pilih Cadangan dari menu navigasi SQL.
  4. Klik Edit.
  5. Di bagian Mengotomatiskan pencadangan, luaskan Opsi lanjutan.
  6. Masukkan Jumlah cadangan yang akan disimpan dalam satu waktu.

    Jumlah tidak boleh kurang dari hari retensi log PITR.

  7. Klik Simpan.

gcloud

Edit instance untuk menetapkan jumlah cadangan otomatis yang akan dipertahankan. Jumlah tidak boleh kurang dari default (tujuh). 

gcloud sql instances patch INSTANCE_NAME \
--retained-backups-count=NUM_TO_RETAIN

Terraform

Untuk menentukan jumlah pencadangan otomatis yang akan dipertahankan untuk instance database, gunakan resource Terraform. 

resource "google_sql_database_instance" "default" {
  name             = "sqlserver-instance-backup-retention"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled = true
      backup_retention_settings {
        retained_backups = 365
        retention_unit   = "COUNT"
      }
    }
  }
}

REST v1beta4

Sebelum menggunakan salah satu data permintaan, buat pengganti berikut:

  • unit: Opsional: Unit retensi dapat berupa bilangan bulat atau string. Nilai yang saat ini didukung (dan nilai default) adalah 1 atau "COUNT".
  • num-to-retain: Jumlah cadangan otomatis yang akan dipertahankan. Jumlah tidak boleh kurang dari jumlah default (7).
  • project-id: ID project
  • instance-id: ID instance

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings":
  {
    "backupConfiguration":
    {
      "backupRetentionSettings":
      {
        "retentionUnit": unit,
        "retainedBackups": "num-to-retain"
      }
    }
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Menonaktifkan pencadangan otomatis

Untuk menonaktifkan pencadangan otomatis untuk instance:

Konsol

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

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Pilih Cadangan dari menu navigasi SQL.
  4. Klik Kelola pencadangan otomatis
  5. Hapus Otomatiskan pencadangan.
  6. Klik Simpan.

gcloud

Edit instance untuk menonaktifkan pencadangan:

gcloud sql instances patch INSTANCE_NAME \
--no-backup

REST v1

REST v1beta4

Menghapus cadangan

Anda dapat menghapus pencadangan otomatis dan pencadangan sesuai permintaan.

Menghapus cadangan mungkin tidak akan mengosongkan ruang penyimpanan sebanyak ukuran cadangan. Hal ini karena cadangan bertambah, sehingga menghapus cadangan yang lama dapat mentransfer beberapa kontennya ke cadangan yang baru untuk menjaga integritas cadangan yang lebih baru.

Konsol

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

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Pilih Cadangan dari menu navigasi SQL.
  4. Klik tindakan lainnya Ikon tindakan lainnya untuk cadangan yang ingin Anda hapus.
  5. Pilih Hapus.
  6. Di jendela Hapus cadangan, ketik Delete dalam kolom, lalu klik Hapus.

gcloud

Menghapus cadangan instance Cloud SQL:

gcloud beta sql backups delete BACKUP_ID \
--instance INSTANCE_NAME

Untuk mengetahui daftar lengkap parameter, lihat lihat halaman referensi perintah gcloud beta sql backup delete.

REST v1

  1. Buat daftar cadangan untuk mendapatkan ID cadangan yang ingin Anda hapus:

    Sebelum menggunakan data permintaan mana pun, lakukan proses penggantian berikut:

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

    Metode HTTP dan URL: 

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

    Untuk mengirim permintaan, perluas salah satu opsi berikut:

    Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

  2. Menghapus cadangan:

    Sebelum menggunakan data permintaan mana pun, lakukan proses penggantian berikut:

    • project-id: ID project
    • instance-id: ID instance
    • backup-id: ID cadangan

    Metode HTTP dan URL: 

    DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id

    Untuk mengirim permintaan, perluas salah satu opsi berikut:

    Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

REST v1beta4

  1. Buat daftar cadangan untuk mendapatkan ID cadangan yang ingin Anda hapus:

    Sebelum menggunakan data permintaan mana pun, lakukan proses penggantian berikut:

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

    Metode HTTP dan URL: 

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

    Untuk mengirim permintaan, perluas salah satu opsi berikut:

    Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

  2. Menghapus cadangan:

    Sebelum menggunakan data permintaan mana pun, lakukan proses penggantian berikut:

    • project-id: ID project
    • instance-id: ID instance
    • backup-id: ID cadangan

    Metode HTTP dan URL: 

    DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns/backup-id

    Untuk mengirim permintaan, perluas salah satu opsi berikut:

    Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Menetapkan lokasi kustom untuk cadangan

Hanya gunakan lokasi cadangan kustom jika diwajibkan oleh peraturan. Jika tidak diperlukan, gunakan lokasi pencadangan multi-region default.

Anda dapat menggunakan lokasi kustom untuk pencadangan sesuai permintaan dan pencadangan otomatis. Untuk mengetahui daftar lengkap nilai lokasi yang valid, lihat Lokasi instance.

Untuk memperbarui instance dengan lokasi kustom:

Konsol

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

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Dari menu navigasi SQL, pilih Cadangan.
  4. Di samping Setelan, klik Edit.
  5. Di bagian Cadangan Otomatis, luaskan Opsi Lanjutan.
  6. Klik Multi-region (default) atau Region.
  7. Pilih lokasi dari menu drop-down Lokasi .
  8. Klik Simpan.

gcloud

Untuk informasi referensi, lihat gcloud sql instances patch. 

gcloud sql instances patch INSTANCE_NAME \
--backup-location=BACKUP_LOCATION

Terraform

Untuk menentukan lokasi kustom untuk pencadangan instance database, gunakan resource Terraform. 

resource "google_sql_database_instance" "default" {
  name             = "sqlserver-instance-with-backup-location"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled  = true
      location = "us-central1"
    }
  }
}

REST v1

Gunakan parameter instance settings.backupConfiguration.location untuk lokasi pencadangan.

Sebelum menggunakan data permintaan mana pun, lakukan proses penggantian berikut:

  • region: Region project
  • backup-region: Region cadangan
  • project-id: ID Project
  • instance-id: ID instance

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "region": "region"
  "settings":
  {
    "backupConfiguration":
    {
      "location": "backup-region",
      "enabled": true,
    }
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

REST v1beta4

Gunakan parameter instance settings.backupConfiguration.location untuk lokasi pencadangan.

Sebelum menggunakan data permintaan mana pun, lakukan proses penggantian berikut:

  • region: Region project
  • backup-region: Region cadangan
  • project-id: ID Project
  • instance-id: ID instance

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "region": "region"
  "settings":
  {
    "backupConfiguration":
    {
      "location": "backup-region",
      "enabled": true,
    }
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Melihat Daftar Cadangan

Untuk melihat daftar cadangan dan detail tentang cadangan, gunakan opsi berikut.

Konsol Google Cloud tidak menampilkan cadangan yang terlewati atau gagal dalam histori pencadangan. Untuk melihat cadangan yang terlewati, gunakan gcloud atau API.

Konsol

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

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Pilih Cadangan dari menu navigasi SQL untuk melihat cadangan terbaru, beserta waktu pembuatan dan jenis cadangan.

gcloud

  • Tampilkan daftar cadangan dari instance: 
    gcloud sql backups list \
--instance INSTANCE_NAME

    Anda dapat memfilter dan mengontrol hasilnya menggunakan parameter daftar standar. Untuk mengetahui daftar lengkapnya, lihat halaman referensi perintah daftar cadangan gcloud sql.

  • Lihat detail dari cadangan dengan menspesifikasi ID pencadangan dari output perintahbackups list. 
    gcloud sql backups describe BACKUP_ID \
--instance INSTANCE_NAME

REST v1

Anda juga dapat menggunakan APIs Explorer di halaman BackupRuns:list untuk mengirim permintaan REST API.

Sebelum menggunakan salah satu data permintaan, buat pengganti berikut:

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

Metode HTTP dan URL: 

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

REST v1beta4

Anda juga dapat menggunakan APIs Explorer di halaman BackupRuns:list untuk mengirim permintaan REST API.

Sebelum menggunakan salah satu data permintaan, buat pengganti berikut:

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

Metode HTTP dan URL: 

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Melihat daftar cadangan selama pemadaman layanan

Saat instance berada di region yang mengalami pemadaman, Anda hanya dapat melihat cadangan untuk instance tersebut menggunakan karakter pengganti (-) dengan backupRuns.list API. Karakter pengganti akan menampilkan semua cadangan dalam project. Lihat Memulihkan ke instance lain.

Ketika terjadi pemadaman layanan di region tempat instance memiliki customer-managed encryption keys (CMEK) yang diaktifkan, Anda tidak dapat memulihkan cadangan untuk instance tersebut ke region lain. Alasannya karena Cloud SQL menggunakan kunci Cloud KMS regional untuk enkripsi saat CMEK diaktifkan pada instance. Untuk memulihkan cadangan instance CMEK, Cloud SQL harus memiliki akses ke kunci CMEK. Dalam gangguan regional, tidak ada akses ke kunci Cloud KMS di region tersebut.

gcloud

  1. Buat daftar cadangan untuk setiap instance dalam project: 
    gcloud sql backups list --instance -

    Perintah ini menampilkan informasi yang mirip dengan berikut ini:

    {
      "kind": "sql#backupRun",
      "status": "SUCCESSFUL",
      "enqueuedTime": "2020-01-21T11:25:33.818Z",
      "id": "backup-id",
      "startTime": "2020-01-21T11:25:33.858Z",
      "endTime": "2020-01-21T11:26:18.663Z",
      "type": "AUTOMATED",
      "windowStartTime": "2020-01-21T10:00:00.479Z",
      "instance": "instance-id",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id",
      "location": "us"
      "backupKind": "SNAPSHOT"
    }
  2. Temukan cadangan untuk instance yang Anda perlukan. Untuk memulihkan cadangan ini, lihat Memulihkan ke instance lain.

REST v1

  1. Tampilkan daftar semua cadangan dalam project:

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: the project ID
    • INSTANCE_ID: ID instance, atau - untuk daftar semua cadangan dalam project

    Metode HTTP dan URL: 

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

    Untuk mengirim permintaan, perluas salah satu opsi berikut:

    Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

  2. Temukan cadangan untuk instance yang Anda perlukan. Untuk memulihkan cadangan ini, lihat Memulihkan ke instance lain.

REST v1beta4

  1. Tampilkan daftar semua cadangan dalam project:

    Sebelum menggunakan salah satu data permintaan, buat pengganti berikut:

    • project-id: ID project
    • instance-id: ID instance, atau - untuk daftar semua cadangan dalam project

    Metode HTTP dan URL: 

    GET https://sqladmin.googleapis.com/v1beta4/projects/project-id/instances/-/backupRuns

    Untuk mengirim permintaan, perluas salah satu opsi berikut:

    Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

  2. Temukan cadangan untuk instance yang Anda perlukan. Untuk memulihkan cadangan ini, lihat Memulihkan ke instance lain.

Lihat lokasi pencadangan

Untuk melihat lokasi cadangan yang diambil untuk instance, gunakan backupRuns:

Konsol

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

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Pilih Cadangan dari menu navigasi SQL.
  4. Dalam daftar cadangan, kolom Lokasi mencantumkan jenis lokasi (multi-region atau region) dan multi-region atau region spesifik untuk setiap cadangan.

gcloud

Untuk informasi referensi, baca gcloud sql instances describe.

  1. Tampilkan daftar cadangan instance: 
    gcloud sql backups list \
--instance INSTANCE_NAME

    Anda dapat memfilter dan mengontrol hasilnya menggunakan parameter daftar standar. Untuk mengetahui daftar lengkapnya, lihat halaman referensi perintah gcloud sql backups list .

  2. Untuk mencantumkan detail satu cadangan, gunakan ID dari output perintah backups list. 
    gcloud sql backups describe BACKUP_ID \
--instance INSTANCE_NAME

REST v1

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

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

Metode HTTP dan URL: 

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Pada contoh sebelumnya:
  • REGION adalah region untuk instance asli.
  • BACKUP_LOCATION adalah lokasi tempat Anda ingin Cloud SQL menyimpan cadangan.

REST v1beta4

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

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

Metode HTTP dan URL: 

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Pada contoh sebelumnya:
  • REGION adalah region untuk instance asli.
  • BACKUP_LOCATION adalah lokasi tempat Anda ingin Cloud SQL menyimpan cadangan.

Melihat ukuran cadangan

Anda dapat melihat ukuran cadangan untuk instance Cloud SQL menggunakan gcloud CLI atau API.

gcloud

  1. Untuk mendapatkan daftar semua cadangan yang terkait dengan project Google Cloud , gunakan perintah gcloud sql backups list:

    gcloud sql backups list

  2. Untuk melihat ukuran cadangan, gunakan perintah gcloud sql backups describe:

    gcloud sql backups describe BACKUP_ID \
--instance=INSTANCE_NAME \
--project=PROJECT_ID

    Lakukan penggantian berikut:

    • BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output menjalankan perintah gcloud sql backups list.
    • INSTANCE_NAME: nama instance.
    • PROJECT_ID: ID atau nomor project dari project Google Cloud yang berisi instance.

    Dalam output, parameter maxChargeableBytes menampilkan ukuran pencadangan (dalam byte).

REST

Mendapatkan daftar cadangan

Gunakan contoh ini untuk mendapatkan daftar semua cadangan yang terkait dengan project Google Cloud . Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman backupRuns.list.

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

Metode HTTP dan URL: 

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Melihat detail tentang cadangan

Gunakan contoh ini untuk melihat detail tentang cadangan, termasuk ukuran cadangan. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman backupRuns.get.

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.
  • BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output menjalankan panggilan sebelumnya.

Metode HTTP dan URL: 

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Mengonfigurasi pencadangan akhir

Anda dapat menyetel instance untuk membuat cadangan secara otomatis dengan mengaktifkan setelan instance cadangan akhir dan menetapkan periode retensi cadangan akhir. Jika Anda tidak mengaktifkan cadangan akhir untuk instance sebelum penghapusan, Anda juga dapat membuat cadangan akhir saat Anda menghapus instance. Untuk mengetahui informasi selengkapnya tentang cara kerja pencadangan akhir, lihat Pencadangan akhir.

Untuk mengelola cadangan akhir setelah instance Anda dihapus, lihat Mengelola cadangan untuk instance yang dihapus.

Mengaktifkan pencadangan akhir

Untuk mengaktifkan cadangan akhir untuk instance, lakukan hal berikut:

Konsol

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

    Buka Instance Cloud SQL

  2. Temukan instance yang ingin Anda aktifkan pencadangan akhirnya. Untuk membuka halaman Ringkasan instance, klik nama instance.

  3. Klik Edit.

  4. Di bagian Customize your instance, luaskan Data Protection.

  5. Untuk mengaktifkan pencadangan akhir, centang kotak untuk Pencadangan akhir saat penghapusan instance di bagian Perlindungan penghapusan instance.

    Periode retensi default adalah 30 hari. Untuk mengubahnya, masukkan angka antara 1 hingga 365 di kotak Hari retensi.

  6. Klik Simpan.

gcloud

Gunakan perintah gcloud sql instances untuk mengaktifkan pencadangan akhir.

  gcloud sql instances patch INSTANCE_NAME \
  --final-backup \
  --final-backup-retention-days=RETENTION_DAYS

Ganti kode berikut:

  • INSTANCE_NAME: nama instance Cloud SQL.
  • RETENTION_DAYS: jumlah hari untuk menyimpan cadangan akhir. Periode ini dapat berkisar dari 1 hingga 365 hari, dan default-nya adalah 30 hari.

REST v1

Untuk mengaktifkan cadangan akhir, lakukan hal berikut:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID
  • INSTANCE_ID: ID instance
  • RETENTION_DAYS: jumlah hari untuk menyimpan cadangan akhir

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": true,
      "retentionDays: RETENTION_DAYS
    }
  }
}

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/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Untuk mengaktifkan cadangan akhir, lakukan hal berikut:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID
  • INSTANCE_ID: ID instance
  • RETENTION_DAYS: jumlah hari untuk menyimpan cadangan akhir

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": true,
      "retentionDays: RETENTION_DAYS
    }
  }
}

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",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Menetapkan retensi cadangan akhir

Untuk menyetel periode retensi cadangan akhir untuk instance, lakukan hal berikut:

Konsol

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

    Buka Instance Cloud SQL

  2. Temukan instance yang ingin Anda aktifkan pencadangan akhirnya. Untuk membuka halaman Ringkasan instance, klik nama instance.

  3. Klik Edit.

  4. Di bagian Customize your instance, luaskan Data Protection.

  5. Untuk mengubah periode retensi cadangan akhir, masukkan angka antara 1 dan 365 di kotak Hari retensi pada setelan Cadangan akhir setelah penghapusan instance.

    Periode retensi default adalah 30 hari.

  6. Klik Simpan.

gcloud

Gunakan perintah gcloud sql instances untuk memperbarui setelan hari retensi pencadangan akhir.

  gcloud sql instances patch INSTANCE_NAME \
  --final-backup-retention-days=RETENTION_DAYS

Ganti kode berikut:

  • INSTANCE_NAME: nama instance Cloud SQL.
  • RETENTION_DAYS: jumlah hari untuk menyimpan cadangan akhir. Periode ini dapat berkisar dari 1 hingga 365 hari, dan default-nya adalah 30 hari.

REST v1

Untuk memperbarui setelan hari retensi cadangan akhir, lakukan hal berikut:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID
  • INSTANCE_ID: ID instance
  • RETENTION_DAYS: jumlah hari untuk menyimpan cadangan akhir

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings": {
    "FinalBackupConfig": {
      "retentionDays: RETENTION_DAYS
    }
  }
}

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/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Untuk memperbarui setelan hari retensi cadangan akhir, lakukan hal berikut:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID
  • INSTANCE_ID: ID instance
  • RETENTION_DAYS: jumlah hari untuk menyimpan cadangan akhir

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings": {
    "FinalBackupConfig": {
      "retentionDays: RETENTION_DAYS
    }
  }
}

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",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Menonaktifkan pencadangan akhir

Untuk menonaktifkan pencadangan akhir untuk instance, lakukan hal berikut:

Konsol

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

    Buka Instance Cloud SQL

  2. Temukan instance yang ingin Anda aktifkan pencadangan akhirnya. Untuk membuka halaman Ringkasan instance, klik nama instance.

  3. Klik Edit.

  4. Di bagian Customize your instance, luaskan Data Protection.

  5. Untuk menonaktifkan pencadangan akhir, hapus centang pada kotak untuk Pencadangan akhir saat penghapusan instance di bagian Perlindungan penghapusan instance.

  6. Klik Simpan.

gcloud

Gunakan perintah gcloud sql instances untuk menonaktifkan pencadangan akhir.

  gcloud sql instances patch INSTANCE_NAME \
  --no-final-backup

Ganti kode berikut:

  • INSTANCE_NAME: nama instance Cloud SQL.

REST v1

Untuk menonaktifkan cadangan akhir, lakukan hal berikut:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID
  • INSTANCE_ID: ID instance

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": false
    }
  }
}

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/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Untuk menonaktifkan cadangan akhir, lakukan hal berikut:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID
  • INSTANCE_ID: ID instance

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": false
    }
  }s
}

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",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Mengonfigurasi cadangan yang dipertahankan

Anda dapat menyetel instance untuk otomatis menyimpan semua cadangan otomatis dan sesuai permintaan saat Anda menghapus instance. Cadangan ini dipertahankan berdasarkan periode retensi cadangan pada saat penghapusan. Untuk mengetahui informasi selengkapnya tentang cara kerja pencadangan akhir, lihat Pencadangan akhir.

Untuk mengelola cadangan yang dipertahankan setelah instance Anda dihapus, lihat Mengelola cadangan untuk instance yang dihapus.

Mengaktifkan pencadangan yang dipertahankan

Untuk mengaktifkan cadangan yang dipertahankan untuk instance, lakukan hal berikut:

Konsol

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

    Buka Instance Cloud SQL

  2. Temukan instance yang ingin Anda aktifkan cadangan yang dipertahankan. Untuk membuka halaman Ringkasan instance, klik nama instance.

  3. Klik Edit.

  4. Di bagian Customize your instance, luaskan Data Protection.

  5. Untuk mengaktifkan cadangan yang dipertahankan, centang kotak untuk Pertahankan cadangan setelah penghapusan instance di bagian Perlindungan penghapusan instance.

  6. Klik Simpan.

gcloud

Gunakan perintah gcloud sql instances untuk mengaktifkan cadangan yang dipertahankan.

  gcloud sql instances patch INSTANCE_NAME \
  --retain-backups-on-delete

Ganti kode berikut:

  • INSTANCE_NAME: nama instance Cloud SQL.

REST v1

Untuk mengaktifkan cadangan yang dipertahankan, lakukan hal berikut:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID
  • INSTANCE_ID: ID instance

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings": {
    "retainBackupsOnDelete": true
    }
  }

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/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Untuk mengaktifkan cadangan yang dipertahankan, lakukan hal berikut:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID
  • INSTANCE_ID: ID instance

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings": {
    "retainBackupsOnDelete": true
    }
  }

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",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Menonaktifkan pencadangan yang dipertahankan

Untuk menonaktifkan pencadangan yang dipertahankan untuk instance, lakukan hal berikut:

Konsol

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

    Buka Instance Cloud SQL

  2. Temukan instance yang ingin Anda aktifkan cadangan yang dipertahankan. Untuk membuka halaman Ringkasan instance, klik nama instance.

  3. Klik Edit.

  4. Di bagian Customize your instance, luaskan Data Protection.

  5. Untuk menonaktifkan cadangan yang dipertahankan, hapus centang pada kotak untuk Pertahankan cadangan setelah penghapusan instance di bagian Perlindungan penghapusan instance.

  6. Klik Simpan.

gcloud

Gunakan perintah gcloud sql instances untuk menonaktifkan cadangan yang dipertahankan.

  gcloud sql instances patch INSTANCE_NAME \
  --no-retain-backups-on-delete

Ganti kode berikut:

  • INSTANCE_NAME: nama instance Cloud SQL.

REST v1

Untuk menonaktifkan cadangan yang dipertahankan, lakukan hal berikut:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID
  • INSTANCE_ID: ID instance

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings": {
    "retainBackupsOnDelete": false
    }
  }

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/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Untuk menonaktifkan cadangan yang dipertahankan, lakukan hal berikut:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID
  • INSTANCE_ID: ID instance

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings": {
    "retainBackupsOnDelete": true
    }
  }

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON yang mirip dengan 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",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Langkah berikutnya