Menghapus beberapa instance

MySQL   |  PostgreSQL   |  SQL Server

Halaman ini menjelaskan cara menghapus instance Cloud SQL.

Peringatan: Semua data pada instance, termasuk cadangan, akan hilang secara permanen jika instance tersebut dihapus. Untuk menyimpan data Anda, ekspor data ke Cloud Storage sebelum menghapusnya. Peran Admin Cloud SQL mencakup izin untuk menghapus instance. Untuk mencegah penghapusan yang tidak disengaja, berikan peran ini hanya jika diperlukan. Selain itu, pertimbangkan proteksi dari penghapusan.

Perhatikan hal-hal berikut saat Anda berencana untuk menghapus instance:

• Setelah Anda menghapus instance, instance tersebut mungkin akan terus muncul di project Anda dengan ukuran yang "tidak diketahui" tetapi dengan status "Sedang dihapus". Hal ini normal, dan instance akan hilang sepenuhnya setelah beberapa saat.
• Diperlukan waktu hingga empat hari agar resource yang mendasarinya terkait dengan instance dihapus sepenuhnya, kecuali replika baca, yang sering kali dihapus dalam beberapa menit.
• Nama instance yang dihapus dapat segera digunakan kembali untuk membuat instance baru.
• Jika proteksi dari penghapusan diaktifkan pada instance, Anda harus menonaktifkannya sebelum menghapus instance.
• Jika terjadi hal yang tidak terduga, buat cadangan terakhir untuk memulihkan instance yang dihapus.

Izin yang diperlukan

Secara default, hanya akun pengguna atau akun layanan dengan peran Cloud SQL Admin (roles/cloudsql.admin) atau Owner (roles/owner) yang memiliki izin untuk menghapus instance Cloud SQL (cloudsql.instances.delete).

Anda juga dapat menentukan peran khusus IAM untuk akun pengguna atau akun layanan yang menyertakan izin cloudsql.instances.delete. Izin ini didukung dalam peran khusus IAM.

Menghapus instance

Anda dapat menghapus instance Cloud SQL menggunakan Google Cloud Konsol, gcloud CLI, atau API. Jika Anda ingin menyimpan cadangan untuk instance sebelum menghapusnya, lihat Mengelola cadangan yang disimpan.

Catatan: Sebelum menghapus instance, pastikan instance aman untuk dihapus. Kemudian, pastikan proteksi dari penghapusan dinonaktifkan untuk instance. Selain itu, sebaiknya buat cadangan terakhir instance sebelum menghapusnya.

Jika Anda menggunakan Cloud Key Management Service untuk mengenkripsi instance, tetapi kunci KMS tidak dapat diakses, setelah Anda menghapus instance, status cadangan terakhir adalah FAILED. Jika hal ini terjadi, minta pemulihan instance Anda dengan menghubungi Cloud Customer Care dalam waktu 4 hari sejak Anda menghapus instance.

Jika Anda menghapus instance yang mengaktifkan Private Service Connect, tindakan berikut akan terjadi:

• Lampiran layanan dihapus secara otomatis. Namun, endpoint Private Service Connect yang mengarah ke lampiran layanan tidak dihapus secara otomatis. Dengan mencantumkan aturan penerusan yang terkait dengan endpoint, Anda dapat melihat bahwa aturan tersebut memiliki status CLOSED. Setelah menerima status ini, Anda dapat menghapus endpoint.
• Anda akan melihat koneksi ke waktu tunggu endpoint.

Untuk menghindari biaya tambahan, sebaiknya hapus juga zona DNS dan data DNS yang sesuai.

Konsol

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

   Buka Instance Cloud SQL

2. Untuk membuka halaman Ringkasan instance, klik nama instance.
3. Klik Hapus.
4. Di dialog Hapus instance, selesaikan tindakan berikut:
1. Di kolom teks, masukkan ID instance yang muncul.

2. Jika Anda ingin membuat cadangan terakhir instance, centang kotak Buat cadangan terakhir, luaskan menu Opsi retensi, lalu, di kolom Simpan selama, masukkan jumlah hari untuk menyimpan cadangan terakhir. Anda dapat menentukan dari 1 hingga 365 hari.

   Jika Anda ingin menghapus instance tanpa membuat cadangan terakhir, hapus centang pada kotak.

3. Di area teks Jelaskan cadangan ini, Anda dapat memberikan deskripsi cadangan.
4. Klik Hapus.

gcloud

Untuk menghapus instance, gunakan perintah gcloud sql instances delete:

gcloud sql instances delete INSTANCE_NAME \
--project=PROJECT_ID

Lakukan penggantian berikut:

• INSTANCE_NAME: nama instance
• PROJECT_ID: ID atau nomor project dari Google Cloud project yang berisi instance yang ingin Anda hapus

Catatan: Jika Anda ingin membuat cadangan terakhir instance, gunakan flag berikut:

• --enable-final-backup: tetapkan nilai flag ini ke true untuk membuat cadangan terakhir. Jika Anda ingin menghapus instance tanpa membuat cadangan terakhir, tetapkan nilai ke false.
• --final-backup-description: berikan detail tentang cadangan terakhir. Nilai defaultnya kosong.
• --final-backup-ttl-days: tentukan jumlah hari untuk menyimpan cadangan terakhir. Hal ini dikenal sebagai time to live (TTL). Nilai defaultnya adalah 30 hari. Periode retensi data yang diizinkan bervariasi, dari 1 hingga 365 hari. Untuk memberikan periode retensi, gunakan flag ini atau --final-backup-expiry-time.
• --final-backup-expiry-time: ini adalah stempel waktu (dalam UTC) saat cadangan ditetapkan untuk berakhir masa berlakunya. Stempel waktu ini tidak boleh melebihi 1 tahun. Untuk memberikan periode retensi, gunakan flag ini atau --final-backup-ttl-days.

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID atau nomor project dari Google Cloud project yang berisi instance yang ingin Anda hapus
• INSTANCE_NAME: nama instance

Catatan: Jika Anda ingin membuat cadangan terakhir instance, gunakan parameter kueri berikut:

• enable_final_backup: tetapkan nilai parameter ini ke true untuk membuat cadangan terakhir. Jika Anda ingin menghapus instance tanpa membuat cadangan terakhir, tetapkan nilai ke false.
• final_backup_description: berikan detail tentang cadangan terakhir. Nilai defaultnya kosong.
• final_backup_ttl_days: tentukan jumlah hari untuk menyimpan cadangan terakhir. Hal ini dikenal sebagai time to live (TTL). Nilai defaultnya adalah 30 hari. Periode retensi data yang diizinkan bervariasi, dari 1 hingga 365 hari. Untuk memberikan periode retensi, gunakan parameter ini atau final_backup_expiry_time.
• final_backup_expiry_time: ini adalah stempel waktu (dalam UTC) saat cadangan ditetapkan untuk berakhir masa berlakunya. Stempel waktu ini tidak boleh melebihi 1 tahun. Untuk memberikan periode retensi, gunakan parameter ini atau final_backup_ttl_days.

Metode HTTP dan URL:

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

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 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 DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

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 DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Untuk melihat cara permintaan REST API yang mendasarinya dibuat untuk tugas ini, lihat APIs Explorer pada halaman instances:hapus.

REST v1beta4

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID atau nomor project dari Google Cloud project yang berisi instance yang ingin Anda hapus
• INSTANCE_NAME: nama instance

Catatan: Jika Anda ingin membuat cadangan terakhir instance, gunakan parameter kueri berikut:

• enable_final_backup: tetapkan nilai parameter ini ke true untuk membuat cadangan terakhir. Jika Anda ingin menghapus instance tanpa membuat cadangan terakhir, tetapkan nilai ke false.
• final_backup_description: berikan detail tentang cadangan terakhir. Nilai defaultnya kosong.
• final_backup_ttl_days: tentukan jumlah hari untuk menyimpan cadangan terakhir. Hal ini dikenal sebagai time to live (TTL). Nilai defaultnya adalah 30 hari. Periode retensi data yang diizinkan bervariasi, dari 1 hingga 365 hari. Untuk memberikan periode retensi, gunakan parameter ini atau final_backup_expiry_time.
• final_backup_expiry_time: ini adalah stempel waktu (dalam UTC) saat cadangan ditetapkan untuk berakhir masa berlakunya. Stempel waktu ini tidak boleh melebihi 1 tahun. Untuk memberikan periode retensi, gunakan parameter ini atau final_backup_ttl_days.

Metode HTTP dan URL:

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

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 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 DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

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 DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Untuk melihat cara permintaan REST API yang mendasarinya dibuat untuk tugas ini, lihat APIs Explorer pada halaman instances:hapus.

Memulihkan instance yang dihapus

Saat Anda menghapus instance, Cloud SQL akan menghapus semua resource untuk instance tersebut, termasuk cadangan on-demand dan cadangan otomatis.

Jika Anda membuat cadangan terakhir sebagai bagian dari penghapusan instance, Anda dapat menggunakan cadangan ini untuk memulihkan instance, baik dengan membuat instance dari cadangan terakhir atau dengan memulihkan cadangan terakhir ke instance yang ada.

Jika Anda menggunakan cadangan terakhir untuk memulihkan instance, instance Anda mungkin memiliki alamat IP yang berbeda dari instance asli yang dihapus.

Jika Anda menghapus instance secara tidak sengaja tanpa membuat cadangan terakhir, Anda dapat meminta pemulihan instance dengan menghubungi Cloud Customer Care dalam waktu 4 hari sejak instance dihapus. Jika instance dapat dipulihkan, konfigurasi instance, termasuk alamat IP yang digunakan sebelum penghapusan, akan dipulihkan. Semua cadangan yang tersedia pada saat penghapusan juga akan dipulihkan.