Mengelola pencadangan akhir

MySQL   |  PostgreSQL   |  SQL Server

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 disaster recovery.

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

Catatan: Anda membuat cadangan akhir sebelum menghapus instance. Untuk mengetahui informasi selengkapnya, lihat Menghapus instance.

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"

   Catatan: Dengan menggunakan perintah ini, Anda dapat mengambil informasi tentang pencadangan, termasuk ID-nya. Anda memerlukan ID cadangan untuk melihat detail tentang cadangan akhir.

   Selain itu, Anda dapat memfilter dan mengontrol hasil dari menjalankan perintah ini menggunakan parameter daftar standar. Untuk mengetahui daftar lengkapnya, lihat halaman referensi perintah gcloud sql backups list.

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:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL"

PowerShell (Windows)

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

Jalankan perintah berikut:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL" | Select-Object -Expand Content

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

Respons

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

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:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

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

PowerShell (Windows)

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

Jalankan perintah berikut:

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

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

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

Tanggapan

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
    }

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:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL"

PowerShell (Windows)

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

Jalankan perintah berikut:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL" | Select-Object -Expand Content

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

Respons

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

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:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

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

PowerShell (Windows)

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

Jalankan perintah berikut:

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

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

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

Respons

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
    }

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"

   Catatan: Dengan menggunakan perintah ini, Anda dapat mengambil informasi tentang pencadangan akhir, termasuk ID-nya. Anda memerlukan ID cadangan untuk memperbarui cadangan akhir.

   Selain itu, Anda dapat memfilter dan mengontrol hasil dari menjalankan perintah ini menggunakan parameter daftar standar. Untuk mengetahui daftar lengkapnya, lihat halaman referensi perintah gcloud sql backups list.

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).
   Gunakan flag --expiry-time atau --ttl-days, bukan keduanya.

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:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL"

PowerShell (Windows)

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

Jalankan perintah berikut:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL" | Select-Object -Expand Content

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

Respons

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

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.

Perbarui cadangan akhir dengan mengubah hari retensi atau dengan memberikan waktu habis masa berlaku yang diperbarui. Jangan gunakan kedua cara tersebut.

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:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan 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/backups/BACKUP_ID?update_mask=ttl_days"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan 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/backups/BACKUP_ID?update_mask=ttl_days" | Select-Object -Expand Content

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

Respons

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "[e-mail]",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

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:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan 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/backups/BACKUP_ID?update_mask=expiry_time"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan 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/backups/BACKUP_ID?update_mask=expiry_time" | Select-Object -Expand Content

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

Respons

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "[e-mail]",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

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:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan 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/backups/BACKUP_ID?update_mask=description"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan 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/backups/BACKUP_ID?update_mask=description" | Select-Object -Expand Content

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

Tanggapan

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "[e-mail]",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

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:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL"

PowerShell (Windows)

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

Jalankan perintah berikut:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL" | Select-Object -Expand Content

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

Respons

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

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.

Perbarui cadangan akhir dengan mengubah hari retensi atau dengan memberikan waktu habis masa berlaku yang diperbarui. Jangan gunakan kedua cara tersebut.

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:

curl (Linux, macOS, atau Cloud Shell)

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

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

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

PowerShell (Windows)

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

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

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

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

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

Respons

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "[e-mail]",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

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:

curl (Linux, macOS, atau Cloud Shell)

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

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

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

PowerShell (Windows)

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

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

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

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

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

Respons

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "[e-mail]",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

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:

curl (Linux, macOS, atau Cloud Shell)

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

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

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

PowerShell (Windows)

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

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

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

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

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

Respons

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "[e-mail]",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

Menghapus cadangan akhir

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

Untuk instance MySQL, menghapus cadangan mungkin tidak mengosongkan ruang penyimpanan sebesar ukuran dari cadangan. Hal ini dikarenakan pencadangan bersifat inkremental, sehingga ketika menghapus cadangan lama, sebagian dari kontennya akan ditranfer ke cadangan yang lebih baru untuk menjaga integritas dari 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 , 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"

   Catatan: Dengan menggunakan perintah ini, Anda dapat mengambil informasi tentang pencadangan, termasuk ID-nya. Anda memerlukan ID cadangan untuk menghapus cadangan akhir.

   Selain itu, Anda dapat memfilter dan mengontrol hasil dari menjalankan perintah ini menggunakan parameter daftar standar. Untuk mengetahui daftar lengkapnya, lihat halaman referensi perintah gcloud sql backups list.

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:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL"

PowerShell (Windows)

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

Jalankan perintah berikut:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL" | Select-Object -Expand Content

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

Respons

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

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:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

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

PowerShell (Windows)

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

Jalankan perintah berikut:

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

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

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

Tanggapan

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "DELETE_BACKUP",
  "name": "OPERATION_ID",
  "targetId": "BACKUP_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL"

PowerShell (Windows)

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

Jalankan perintah berikut:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL" | Select-Object -Expand Content

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

Respons

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

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:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

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

PowerShell (Windows)

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

Jalankan perintah berikut:

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

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

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

Tanggapan

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "DELETE_BACKUP",
  "name": "OPERATION_ID",
  "targetId": "BACKUP_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Langkah berikutnya

• Pelajari lebih lanjut tentang pencadangan data Anda.
• Pelajari lebih lanjut tentang memulihkan data.
• Lihat cara memulihkan data Anda dari cadangan.