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
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.
Di konsol Google Cloud, buka halaman Cloud SQL Backups.
Halaman ini mencantumkan semua cadangan, termasuk cadangan akhir, yang terkait dengan project Google Cloud.
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
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"
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
.
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)
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)
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)
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)
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 }
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)
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)
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)
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)
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.
Di konsol Google Cloud, buka halaman Cloud SQL Backups.
Halaman ini mencantumkan semua cadangan, termasuk cadangan akhir, yang terkait dengan project Google Cloud.
- Untuk memperbarui cadangan akhir, klik cadangan. Dialog Final backup akan muncul.
- Untuk memperbarui durasi penyimpanan cadangan akhir oleh Cloud SQL, selesaikan tindakan berikut:
- Klik ikon Edit retensi di samping kolom Cadangan disimpan hingga.
- Klik ikon Select date di samping kolom Retain backup until.
- Di kalender, pilih tanggal baru yang menunjukkan berapa lama Cloud SQL menyimpan cadangan akhir.
- Klik Perbarui. Anda akan kembali ke halaman Pencadangan Cloud SQL.
- Untuk memperbarui deskripsi cadangan akhir, selesaikan tindakan berikut:
- Klik pencadangan akhir.
- Klik ikon Edit deskripsi di samping kolom Deskripsi.
- Di kolom Jelaskan pencadangan ini, masukkan deskripsi yang diperbarui untuk pencadangan akhir.
- Klik Perbarui. Anda akan kembali ke halaman Pencadangan Cloud SQL.
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"
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).
- Untuk flag
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)
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)
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.
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)
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)
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": "user@example.com", "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)
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)
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": "user@example.com", "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)
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)
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": "user@example.com", "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 " }
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)
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)
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.
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)
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)
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": "user@example.com", "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)
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)
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": "user@example.com", "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)
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)
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": "user@example.com", "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.Di konsol Google Cloud, buka halaman Cloud SQL Backups.
Halaman ini mencantumkan semua cadangan, termasuk cadangan akhir, yang terkait dengan project Google Cloud.
- Untuk cadangan akhir yang ingin Anda hapus, klik tindakan lainnya
, lalu pilih Hapus.
- Di jendela Hapus cadangan akhir?, masukkan nama instance yang Anda gunakan untuk membuat cadangan akhir, lalu klik Hapus.
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"
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
.
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)
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)
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)
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)
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": "user@example.com", "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 " }
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)
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)
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)
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)
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": "user@example.com", "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.