Halaman ini diterjemahkan oleh Cloud Translation API.

Hapus beberapa instance

MySQL | PostgreSQL | SQL Server

Halaman ini menjelaskan cara menghapus instance Cloud SQL.

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 satu minggu 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 perlindungan penghapusan diaktifkan pada instance, Anda harus menonaktifkannya sebelum menghapus instance.
Jika terjadi hal yang tidak terduga, 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.

Catatan: Sebelum Anda menghapus instance, pastikan bahwa instance aman untuk dihapus. Kemudian, pastikan bahwa perlindungan penghapusan dinonaktifkan untuk instance tersebut. Selain itu, sebaiknya Anda membuat cadangan akhir 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 akhir adalah FAILED. Jika hal ini terjadi, minta untuk memulihkan 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 melihat koneksi ke waktu tunggu endpoint.

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

Konsol

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Untuk membuka halaman Ringkasan instance, klik nama instance.
Klik Hapus.
Pada dialog Delete instance, selesaikan tindakan berikut:

Di kolom teks, masukkan ID instance yang muncul.
Jika Anda ingin membuat pencadangan akhir instance, biarkan kotak centang Buat pencadangan akhir dicentang, luaskan menu Opsi retensi, lalu, di kolom Simpan selama, masukkan jumlah hari untuk mempertahankan pencadangan akhir. Anda dapat menentukan dari 1 hingga 365 hari.

Jika Anda ingin menghapus instance tanpa membuat cadangan akhir, hapus centang pada kotak.
Di area teks Jelaskan cadangan ini, Anda dapat memberikan deskripsi cadangan.
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 project Google Cloud yang berisi instance yang ingin Anda hapus

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

--enable-final-backup: tetapkan nilai tanda 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 cadangan 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 pencadangan ditetapkan. Periode 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 project Google Cloud yang berisi instance yang ingin Anda hapus
INSTANCE_NAME: nama instance

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

enable_final_backup: tetapkan nilai parameter ini ke true untuk mengambil pencadangan akhir. Jika Anda ingin menghapus instance tanpa membuat cadangan akhir, tetapkan nilainya ke false.
final_backup_description: memberikan detail tentang cadangan 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 pencadangan ditetapkan. Periode 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, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

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

PowerShell (Windows)

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

Jalankan perintah berikut:

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/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": "user@example.com",
  "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 di halaman instances:delete.

REST v1beta4

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

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

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

enable_final_backup: tetapkan nilai parameter ini ke true untuk mengambil pencadangan akhir. Jika Anda ingin menghapus instance tanpa membuat cadangan akhir, tetapkan nilainya ke false.
final_backup_description: memberikan detail tentang cadangan 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 pencadangan ditetapkan. Periode 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, 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/instances/INSTANCE_NAME"

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/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": "user@example.com",
  "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 membuat cadangan akhir, Anda dapat meminta pemulihan instance dengan menghubungi Layanan Pelanggan Cloud 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.