Menghapus beberapa instance

MySQL   |  PostgreSQL   |  SQL Server

Dengan menghapus instance Cloud SQL, Anda dapat menghapus database yang tidak diperlukan secara permanen dan berhenti dikenai biaya komputasi dan penyimpanan. Karena penghapusan akan menghapus data dan cadangan instance secara permanen, Anda dapat membuat cadangan terakhir atau mengekspor data ke Cloud Storage terlebih dahulu untuk menyimpan informasi Anda. Sebelum menghapus instance utama, Anda harus menghapus semua replika baca terlebih dahulu dan menonaktifkan proteksi dari penghapusan jika diaktifkan.

Sebelum memulai

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 menghapus instance:

• Anda tidak dapat menghapus instance yang memiliki replika. Anda harus menghapus semua replika terlebih dahulu.
  Anda dapat mengurangi peluang menghapus instance secara tidak sengaja dengan membuat replika; replika harus dihapus sebelum instance utamanya.
• Setelah dihapus, instance mungkin 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 keadaan darurat, buat cadangan akhir 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 konsol Google Cloud , gcloud CLI, atau API. Jika Anda ingin mempertahankan cadangan untuk instance Anda sebelum menghapus, lihat Mengelola cadangan yang dipertahankan.

Catatan: Sebelum menghapus instance, pastikan bahwa tindakan tersebut aman. Kemudian, pastikan bahwa proteksi dari penghapusan dinonaktifkan untuk instance tersebut. Selain itu, sebaiknya buat cadangan akhir instance sebelum Anda menghapusnya.

Jika Anda menggunakan Cloud Key Management Service untuk mengenkripsi instance, tetapi kunci KMS tidak dapat diakses, setelah Anda menghapus instance, status pencadangan akhir 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 telah 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 melihat koneksi ke waktu tunggu endpoint.

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

Konsol

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

   Buka Instance Cloud SQL

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

2. Jika Anda ingin membuat cadangan akhir instance, biarkan kotak centang Take a final backup tetap dicentang, luaskan menu Retention options, lalu di kolom Retain for, masukkan jumlah hari untuk mempertahankan cadangan akhir. Anda dapat menentukan dari 1 hingga 365 hari.

   Jika Anda ingin menghapus instance tanpa melakukan pencadangan akhir, hapus centang pada kotak.

3. Di area teks Describe this backup, 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 project Google Cloud yang berisi instance yang ingin Anda hapus

Catatan: Jika Anda ingin mengambil cadangan akhir instance, gunakan flag berikut:

• --enable-final-backup: tetapkan nilai flag ini ke true untuk melakukan pencadangan akhir. Jika Anda ingin menghapus instance tanpa membuat cadangan akhir, tetapkan nilainya ke false.
• --final-backup-description: memberikan detail tentang pencadangan akhir. Nilai defaultnya kosong.
• --final-backup-ttl-days: menentukan jumlah hari untuk mempertahankan cadangan akhir. Hal ini dikenal sebagai time to live (TTL). Nilai defaultnya adalah 30 hari. Periode retensi 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 masa berlaku cadangan ditetapkan untuk berakhir. Durasi ini tidak boleh lebih dari 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 project Google Cloud yang berisi instance yang ingin Anda hapus
• INSTANCE_NAME: nama instance

Catatan: Jika Anda ingin mengambil cadangan akhir instance, gunakan parameter kueri berikut:

• enable_final_backup: tetapkan nilai parameter ini ke true untuk melakukan pencadangan akhir. Jika Anda ingin menghapus instance tanpa membuat cadangan akhir, tetapkan nilainya ke false.
• final_backup_description: memberikan detail tentang pencadangan akhir. Nilai defaultnya kosong.
• final_backup_ttl_days: menentukan jumlah hari untuk mempertahankan cadangan akhir. Hal ini dikenal sebagai time to live (TTL). Nilai defaultnya adalah 30 hari. Periode retensi 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 masa berlaku cadangan ditetapkan untuk berakhir. Durasi ini tidak boleh lebih dari 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:delete.

REST v1beta4

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

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

Catatan: Jika Anda ingin mengambil cadangan akhir instance, gunakan parameter kueri berikut:

• enable_final_backup: tetapkan nilai parameter ini ke true untuk melakukan pencadangan akhir. Jika Anda ingin menghapus instance tanpa membuat cadangan akhir, tetapkan nilainya ke false.
• final_backup_description: memberikan detail tentang pencadangan akhir. Nilai defaultnya kosong.
• final_backup_ttl_days: menentukan jumlah hari untuk mempertahankan cadangan akhir. Hal ini dikenal sebagai time to live (TTL). Nilai defaultnya adalah 30 hari. Periode retensi 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 masa berlaku cadangan ditetapkan untuk berakhir. Durasi ini tidak boleh lebih dari 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 di halaman instances:delete.

Memulihkan instance yang dihapus

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

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

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

Jika Anda tidak sengaja menghapus instance tanpa melakukan pencadangan akhir, Anda dapat meminta untuk memulihkan 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.