Beberapa atau semua informasi di halaman ini mungkin tidak berlaku untuk Trusted Cloud oleh S3NS.

Halaman ini diterjemahkan oleh Cloud Translation API.

Mengelola pencadangan akhir

MySQL | PostgreSQL | SQL Server

Halaman ini menjelaskan cara mengelola cadangan 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 begitu, Anda dapat membuat ulang instance yang tidak sengaja dihapus atau menggunakan instance ini untuk skenario pemulihan dari bencana.

Tidak seperti pencadangan otomatis dan sesuai permintaan, yang terkait dengan instance, Anda dapat membuat cadangan akhir sebelum menghapus instance. Cloud SQL menyimpan cadangan ini 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:

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 artikel Tentang cadangan Cloud SQL.

Izin yang diperlukan

Trusted Cloud console

Untuk mengelola cadangan akhir dalam project Trusted 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 cadangan akhir dalam project Trusted 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 cadangan akhir dalam project Trusted Cloud , Anda memerlukan izin berikut:

Tindakan	Metode	Izin yang diperlukan
Mencantumkan cadangan akhir	`Backups.ListBackups`	`cloudsql.backupRuns.list`
Mendeskripsikan pencadangan akhir	`Backups.GetBackup`	`cloudsql.backupRuns.get`
Memperbarui cadangan akhir	`Backups.UpdateBackup`	`cloudsql.backupRuns.update`
Menghapus cadangan akhir	`Backups.DeleteBackup`	`cloudsql.backupRuns.delete`

Melihat daftar cadangan akhir

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

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

Konsol

Di konsol Trusted Cloud , buka halaman Cadangan Cloud SQL.

Buka Cadangan Cloud SQL

Halaman ini mencantumkan semua cadangan, termasuk cadangan akhir, yang terkait dengan project Trusted Cloud .
Untuk melihat detail tentang pencadangan akhir, klik cadangan. 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 terakhir
- Deskripsi cadangan akhir

gcloud

Untuk mendapatkan daftar semua cadangan akhir yang terkait dengan project Trusted Cloud , gunakan perintah gcloud sql backups list:
```
gcloud sql backups list \
--filter="type=FINAL"
```
Catatan: Dengan menggunakan perintah ini, Anda dapat mengambil informasi tentang cadangan, termasuk ID-nya. Anda memerlukan ID cadangan untuk melihat detail tentang cadangan akhir.

Selain itu, Anda dapat memfilter dan mengontrol hasil menjalankan perintah ini menggunakan parameter daftar standar. Untuk mengetahui daftar lengkapnya, lihat halaman referensi perintah gcloud sql backups list.
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 cadangan akhir yang terkait dengan project Trusted Cloud . Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman Backups.ListBackups.

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 menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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 menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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 Backups.GetBackup.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

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

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/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
    }

REST v1beta4

Mendapatkan daftar cadangan akhir

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 Backups.GetBackup.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID.
BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output 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 berapa lama Cloud SQL menyimpan cadangan akhir untuk instance dan deskripsi cadangan menggunakan Trusted Cloud konsol, gcloud CLI, atau Cloud SQL API.

Konsol

Di konsol Trusted Cloud , buka halaman Cadangan Cloud SQL.

Buka Cadangan Cloud SQL

Halaman ini mencantumkan semua cadangan, termasuk cadangan akhir, yang terkait dengan project Trusted Cloud .
Untuk memperbarui cadangan akhir, klik cadangan. Dialog Final backup akan muncul.
Untuk memperbarui durasi Cloud SQL menyimpan cadangan akhir, selesaikan tindakan berikut:
1. Klik ikon Edit retensi di samping kolom Cadangan dipertahankan hingga.
2. Klik ikon Pilih tanggal di samping kolom Pertahankan cadangan hingga.
3. Di kalender, pilih tanggal baru yang menunjukkan berapa lama Cloud SQL menyimpan cadangan akhir.
4. Klik Perbarui. Anda akan kembali ke halaman Cadangan Cloud SQL.
Untuk memperbarui deskripsi cadangan akhir, selesaikan tindakan berikut:
1. Klik cadangan terakhir.
2. Klik ikon Edit deskripsi di samping kolom Deskripsi.
3. Di kolom Jelaskan cadangan ini, masukkan deskripsi yang diperbarui untuk cadangan akhir.
4. Klik Perbarui. Anda akan kembali ke halaman Cadangan Cloud SQL.

gcloud

Untuk mendapatkan daftar semua cadangan akhir yang terkait dengan project Trusted 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 menjalankan perintah ini menggunakan parameter daftar standar. Untuk mengetahui daftar lengkapnya, lihat halaman referensi perintah gcloud sql backups list.
Untuk memperbarui deskripsi dan periode retensi cadangan 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 tanda --expiry-time, tentukan stempel tanggal dan waktu saat Cloud SQL menghapus cadangan terakhir secara otomatis.
- Untuk tanda --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, jangan keduanya.

REST v1

Mendapatkan daftar cadangan akhir

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 Cloud SQL menyimpan cadangan.
Waktu habis masa berlaku: Berikan stempel tanggal dan waktu yang diperbarui untuk saat Cloud SQL menghapus cadangan secara otomatis.

Perbarui hari retensi

Gunakan contoh ini untuk memperbarui jumlah hari Cloud SQL menyimpan cadangan akhir. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman Backups.UpdateBackup.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID.
BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output 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 Backups.UpdateBackup.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID.
BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output menjalankan panggilan sebelumnya.
DATE_AND_TIME_STAMP: stempel tanggal dan waktu saat Cloud SQL menghapus pencadangan terakhir 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 cadangan akhir. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman Backups.UpdateBackup.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID.
BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output menjalankan panggilan sebelumnya.
DESCRIPTION: deskripsi yang diperbarui untuk cadangan 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"
}

REST v1beta4

Mendapatkan daftar cadangan akhir

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: Ubah jumlah hari Cloud SQL menyimpan cadangan
Waktu habis masa berlaku: Berikan stempel tanggal dan waktu yang diperbarui untuk saat Cloud SQL menghapus cadangan secara otomatis.

Perbarui hari retensi

Gunakan contoh ini untuk memperbarui jumlah hari Cloud SQL menyimpan cadangan akhir. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman Backups.UpdateBackup.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID.
BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output 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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID.
BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output menjalankan panggilan sebelumnya.
DATE_AND_TIME_STAMP: stempel tanggal dan waktu saat Cloud SQL menghapus pencadangan terakhir 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 cadangan akhir. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat halaman Backups.UpdateBackup.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID.
BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output menjalankan panggilan sebelumnya.
DESCRIPTION: deskripsi yang diperbarui untuk cadangan 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 Trusted Cloud konsol, 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

Di konsol Trusted Cloud , buka halaman Cadangan Cloud SQL.

Buka Cadangan Cloud SQL

Halaman ini mencantumkan semua cadangan, termasuk cadangan akhir, yang terkait dengan project Trusted Cloud .
Untuk cadangan terakhir 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.

gcloud

Untuk mendapatkan daftar semua cadangan akhir yang terkait dengan project Trusted Cloud , gunakan perintah gcloud sql backups list:
```
gcloud sql backups list \
--filter="type=FINAL"
```
Catatan: Dengan menggunakan perintah ini, Anda dapat mengambil informasi tentang cadangan, termasuk ID-nya. Anda memerlukan ID cadangan untuk menghapus cadangan akhir.

Selain itu, Anda dapat memfilter dan mengontrol hasil menjalankan perintah ini menggunakan parameter daftar standar. Untuk mengetahui daftar lengkapnya, lihat halaman referensi perintah gcloud sql backups list.
Untuk menghapus cadangan 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

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 Backups.DeleteBackup.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID.
BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output 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"
}

REST v1beta4

Mendapatkan daftar cadangan akhir

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 Backups.DeleteBackup.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID.
BACKUP_ID: ID cadangan. Anda mendapatkan ID ini dari output 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"
}