Mengelola pencadangan akhir

Halaman ini menjelaskan cara mengelola pencadangan akhir untuk instance Cloud SQL Anda. Sebelum menghapus instance, Anda dapat membuat cadangan akhir instance tersebut. Selanjutnya, Anda dapat memulihkan cadangan akhir ke instance baru atau yang sudah ada. Dengan demikian, Anda dapat membuat ulang instance yang tidak sengaja dihapus atau menggunakan instance ini untuk skenario pemulihan dari bencana.

Tidak seperti pencadangan otomatis dan pencadangan sesuai permintaan, yang dikaitkan dengan instance, Anda dapat membuat cadangan akhir sebelum menghapus instance. Cloud SQL menyimpan cadangan ini hingga di luar masa aktif instance.

Anda dapat menggunakan perintah gcloud CLI yang ada untuk mencantumkan, mendeskripsikan, memperbarui, dan menghapus cadangan akhir. Jika Anda menggunakan peran khusus, tambahkan izin berikut ke peran tersebut:

  • cloudsql.backupRuns.list
  • cloudsql.backupRuns.get
  • cloudsql.backupRuns.update
  • cloudsql.backupRuns.delete

Untuk mengetahui informasi selengkapnya tentang izin ini, lihat Izin yang diperlukan. Selain itu, untuk mengetahui informasi selengkapnya tentang cara kerja pencadangan, lihat Tentang pencadangan Cloud SQL.

Izin yang diperlukan

Konsol Google Cloud

Untuk mengelola pencadangan akhir di project Google Cloud, Anda memerlukan izin berikut:

Tugas Izin yang diperlukan
Mencantumkan cadangan akhir cloudsql.backupRuns.list
Mendeskripsikan pencadangan akhir cloudsql.backupRuns.get
Memperbarui cadangan akhir cloudsql.backupRuns.update
Menghapus cadangan akhir cloudsql.backupRuns.delete

gcloud CLI

Untuk mengelola pencadangan akhir di project Google Cloud, Anda memerlukan izin berikut:

Tindakan Perintah Izin yang diperlukan
Mencantumkan cadangan akhir gcloud sql backups list cloudsql.backupRuns.list
Mendeskripsikan pencadangan akhir gcloud sql backups describe cloudsql.backupRuns.get
Memperbarui cadangan akhir gcloud sql backups patch cloudsql.backupRuns.update
Menghapus cadangan akhir gcloud sql backups delete cloudsql.backupRuns.delete

REST

Untuk mengelola pencadangan akhir di project Google Cloud, Anda memerlukan izin berikut:

Tindakan Metode Izin yang diperlukan
Mencantumkan cadangan akhir backups.list cloudsql.backupRuns.list
Mendeskripsikan pencadangan akhir backups.describe cloudsql.backupRuns.get
Memperbarui cadangan akhir backups.patch cloudsql.backupRuns.update
Menghapus cadangan akhir backups.delete cloudsql.backupRuns.delete

Melihat daftar cadangan akhir

Anda dapat melihat daftar cadangan akhir dan detail tentang cadangan menggunakan konsol Google Cloud, gcloud CLI, atau Cloud SQL API.

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

Konsol

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

    Buka Pencadangan Cloud SQL

    Halaman ini mencantumkan semua cadangan, termasuk cadangan akhir, yang terkait dengan project Google Cloud.

  2. Untuk melihat detail tentang pencadangan akhir, klik pencadangan. Dialog Final backup akan muncul. Dialog ini menampilkan informasi berikut:

    • Tanggal dan waktu saat instance, yang digunakan untuk membuat cadangan akhir, dihapus
    • Nama dan versi instance yang dihapus
    • Stempel tanggal dan waktu tentang berapa lama Cloud SQL menyimpan cadangan akhir
    • Deskripsi pencadangan akhir

gcloud

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

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Untuk melihat detail tentang pencadangan akhir, gunakan perintah gcloud sql backups describe:

    gcloud sql backups describe \
    BACKUP_NAME

    Anda mendapatkan BACKUP_NAME dari output menjalankan perintah gcloud sql backups list. BACKUP_NAME memiliki format berikut: projects/PROJECT_ID/backups/BACKUP_ID.

REST v1

Mendapatkan daftar cadangan akhir

Gunakan contoh ini untuk mendapatkan daftar semua pencadangan akhir 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: project ID
  • INSTANCE_ID: ID instance

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

Untuk mengirim permintaan, perluas salah satu opsi berikut:

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

Melihat detail tentang pencadangan akhir

Gunakan contoh ini untuk melihat detail tentang pencadangan akhir. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman backupRuns.get.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID.
  • BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output saat menjalankan panggilan sebelumnya.

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID

Untuk mengirim permintaan, perluas salah satu opsi berikut:

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

REST v1beta4

Mendapatkan daftar cadangan akhir

Gunakan contoh ini untuk mendapatkan daftar semua pencadangan akhir 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: project ID
  • INSTANCE_ID: ID instance

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

Untuk mengirim permintaan, perluas salah satu opsi berikut:

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

Melihat detail tentang pencadangan akhir

Gunakan contoh ini untuk melihat detail tentang pencadangan akhir. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman backupRuns.get.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID.
  • BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output saat menjalankan panggilan sebelumnya.

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID

Untuk mengirim permintaan, perluas salah satu opsi berikut:

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

Memperbarui cadangan akhir

Anda dapat memperbarui durasi Cloud SQL menyimpan cadangan akhir untuk instance dan deskripsi untuk cadangan menggunakan konsol Google Cloud, gcloud CLI, atau Cloud SQL API.

Konsol

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

    Buka Pencadangan Cloud SQL

    Halaman ini mencantumkan semua cadangan, termasuk cadangan akhir, yang terkait dengan project Google Cloud.

  2. Untuk memperbarui cadangan akhir, klik cadangan. Dialog Final backup akan muncul.
  3. Untuk memperbarui durasi penyimpanan cadangan akhir oleh Cloud SQL, selesaikan tindakan berikut:
    1. Klik ikon Edit retensi di samping kolom Cadangan disimpan hingga.
    2. Klik ikon Select date di samping kolom Retain backup until.
    3. Di kalender, pilih tanggal baru yang menunjukkan berapa lama Cloud SQL menyimpan cadangan akhir.
    4. Klik Perbarui. Anda akan kembali ke halaman Pencadangan Cloud SQL.
  4. Untuk memperbarui deskripsi cadangan akhir, selesaikan tindakan berikut:
    1. Klik pencadangan akhir.
    2. Klik ikon Edit deskripsi di samping kolom Deskripsi.
    3. Di kolom Jelaskan pencadangan ini, masukkan deskripsi yang diperbarui untuk pencadangan akhir.
    4. Klik Perbarui. Anda akan kembali ke halaman Pencadangan Cloud SQL.

gcloud

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

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Untuk memperbarui deskripsi dan periode retensi data pencadangan akhir, gunakan perintah gcloud sql backups patch:

    gcloud sql backups patch \
    BACKUP_NAME  \
    --description=DESCRIPTION /
    --expiry-time=DATE-AND-TIME-STAMP | --ttl-days=NUMBER-OF-DAYS

    Anda mendapatkan BACKUP_NAME dari output menjalankan perintah gcloud sql backups list. BACKUP_NAME memiliki format berikut: projects/PROJECT_ID/backups/BACKUP_ID.

    Untuk flag --expiry-time dan --ttl-days, gunakan panduan berikut:

    • Untuk flag --expiry-time, tentukan stempel tanggal dan waktu saat Cloud SQL menghapus cadangan akhir secara otomatis.
    • Untuk flag --ttl-days, tentukan periode retensi cadangan akhir (dari 1 hingga 365 hari). Hal ini dikenal sebagai time to live (TTL). Periode retensi dimulai dari tanggal dan waktu saat ini, dan periode retensi maksimum yang diizinkan Cloud SQL adalah 1 tahun (atau 365 hari).

REST v1

Mendapatkan daftar cadangan akhir

Gunakan contoh ini untuk mendapatkan daftar semua pencadangan akhir 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: project ID
  • INSTANCE_ID: ID instance

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

Untuk mengirim permintaan, perluas salah satu opsi berikut:

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

Memperbarui periode retensi data

Anda dapat memperbarui periode retensi data pencadangan akhir dengan salah satu cara berikut:

  • Hari retensi: Ubah jumlah hari yang dipertahankan Cloud SQL untuk cadangan.
  • Waktu habis masa berlaku: Berikan stempel tanggal dan waktu yang diperbarui untuk saat Cloud SQL menghapus cadangan secara otomatis.
Memperbarui hari retensi

Gunakan contoh ini untuk memperbarui jumlah hari yang dipertahankan Cloud SQL untuk cadangan akhir. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman backupRuns.update.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID.
  • BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output saat menjalankan panggilan sebelumnya.
  • TTL_DAYS: periode retensi cadangan akhir (dari 1 hingga 365 hari). Hal ini dikenal sebagai time to live (TTL). Periode retensi dimulai dari tanggal dan waktu saat ini, dan periode retensi maksimum yang diizinkan Cloud SQL adalah 1 tahun (atau 365 hari).

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days

Meminta isi JSON:

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

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

Memperbarui waktu habis masa berlaku

Gunakan contoh ini untuk memberikan stempel tanggal dan waktu yang diperbarui saat Cloud SQL menghapus cadangan. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman backupRuns.update.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID.
  • BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output saat menjalankan panggilan sebelumnya.
  • DATE_AND_TIME_STAMP: stempel tanggal dan waktu saat Cloud SQL menghapus pencadangan akhir secara otomatis.

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

Meminta isi JSON:

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

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

Memperbarui deskripsi

Gunakan contoh ini untuk memperbarui deskripsi pencadangan akhir. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman backupRuns.update.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID.
  • BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output saat menjalankan panggilan sebelumnya.
  • DESCRIPTION: deskripsi yang diperbarui untuk pencadangan akhir.

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

Meminta isi JSON:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

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

REST v1beta4

Mendapatkan daftar cadangan akhir

Gunakan contoh ini untuk mendapatkan daftar semua pencadangan akhir 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: project ID
  • INSTANCE_ID: ID instance

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

Untuk mengirim permintaan, perluas salah satu opsi berikut:

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

Memperbarui periode retensi data

Anda dapat memperbarui periode retensi data pencadangan akhir dengan salah satu cara berikut:

  • Hari retensi: Mengubah jumlah hari yang dipertahankan Cloud SQL untuk cadangan
  • Waktu habis masa berlaku: Berikan stempel tanggal dan waktu yang diperbarui untuk saat Cloud SQL menghapus cadangan secara otomatis.
Memperbarui hari retensi

Gunakan contoh ini untuk memperbarui jumlah hari yang dipertahankan Cloud SQL untuk cadangan akhir. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman backupRuns.update.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID.
  • BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output saat menjalankan panggilan sebelumnya.
  • TTL_DAYS: periode retensi cadangan akhir (dari 1 hingga 365 hari). Hal ini dikenal sebagai time to live (TTL). Periode retensi dimulai dari tanggal dan waktu saat ini, dan periode retensi maksimum yang diizinkan Cloud SQL adalah 1 tahun (atau 365 hari).

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days

Meminta isi JSON:

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

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

Memperbarui waktu habis masa berlaku

Gunakan contoh ini untuk memberikan stempel tanggal dan waktu yang diperbarui saat Cloud SQL menghapus cadangan. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman backupRuns.update.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID.
  • BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output saat menjalankan panggilan sebelumnya.
  • DATE_AND_TIME_STAMP: stempel tanggal dan waktu saat Cloud SQL menghapus pencadangan akhir secara otomatis.

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

Meminta isi JSON:

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

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

Memperbarui deskripsi

Gunakan contoh ini untuk memperbarui deskripsi pencadangan akhir. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman backupRuns.update.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID.
  • BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output saat menjalankan panggilan sebelumnya.
  • DESCRIPTION: deskripsi yang diperbarui untuk pencadangan akhir.

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

Meminta isi JSON:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

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

Menghapus cadangan akhir

Anda dapat menghapus cadangan akhir menggunakan konsol Google Cloud, gcloud CLI, atau Cloud SQL API.

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 Cloud SQL Backups.

    Buka Pencadangan Cloud SQL

    Halaman ini mencantumkan semua cadangan, termasuk cadangan akhir, yang terkait dengan project Google Cloud.

  2. Untuk cadangan akhir yang ingin Anda hapus, klik tindakan lainnya Ikon tindakan lainnya., lalu pilih Hapus.
  3. Di jendela Hapus cadangan akhir?, masukkan nama instance yang Anda gunakan untuk membuat cadangan akhir, lalu klik Hapus.

gcloud

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

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Untuk menghapus pencadangan akhir, gunakan perintah gcloud sql backups delete:

    gcloud sql backups delete \
    BACKUP_NAME

    Anda mendapatkan BACKUP_NAME dari output menjalankan perintah gcloud sql backups list. BACKUP_NAME memiliki format berikut: projects/PROJECT_ID/backups/BACKUP_ID.

REST v1

Mendapatkan daftar cadangan akhir

Gunakan contoh ini untuk mendapatkan daftar semua pencadangan akhir 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: project ID
  • INSTANCE_ID: ID instance

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

Untuk mengirim permintaan, perluas salah satu opsi berikut:

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

Menghapus cadangan akhir

Gunakan contoh ini untuk menghapus cadangan akhir. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman backupRuns.delete.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID.
  • BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output saat menjalankan panggilan sebelumnya.

Metode HTTP dan URL:

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID

Untuk mengirim permintaan, perluas salah satu opsi berikut:

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

REST v1beta4

Mendapatkan daftar cadangan akhir

Gunakan contoh ini untuk mendapatkan daftar semua pencadangan akhir 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: project ID
  • INSTANCE_ID: ID instance

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

Untuk mengirim permintaan, perluas salah satu opsi berikut:

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

Menghapus cadangan akhir

Gunakan contoh ini untuk menghapus cadangan akhir. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman backupRuns.delete.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID.
  • BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output saat menjalankan panggilan sebelumnya.

Metode HTTP dan URL:

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID

Untuk mengirim permintaan, perluas salah satu opsi berikut:

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

Langkah berikutnya