Edit instance

Halaman ini menjelaskan cara mengedit instance Cloud SQL yang ada.

Setelah membuat instance, Anda dapat mengeditnya saat sedang berjalan untuk mengubah setelannya. Untuk informasi tentang setelan instance dan bagaimana perubahan setelan dapat memengaruhi instance, lihat Setelan Instance.

Anda dapat mengintegrasikan Cloud SQL untuk SQL Server dengan Layanan Terkelola untuk Microsoft Active Directory (Microsoft AD Terkelola). Integrasi ini mencakup kemampuan untuk bergabung dan keluar dari domain Microsoft AD Terkelola di tingkat per instance. Untuk informasi selengkapnya, lihat Ringkasan Microsoft AD Terkelola di Cloud SQL.

Anda juga dapat mengaktifkan atau menonaktifkan audit database.

Mengedit instance

Sebagian besar pengeditan dapat diterapkan ke instance hanya saat instance tersebut sedang berjalan.

Console

  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 Edit.
  4. Di bagian Sesuaikan instance Anda, jika menu Tampilkan opsi konfigurasi muncul, klik menu tersebut.
  5. Perbarui setelan yang dapat diedit untuk instance Anda.

    Pelajari lebih lanjut setelan instance.

  6. Klik Simpan.

gcloud

Perintah ini memodifikasi waktu mulai pencadangan.

gcloud sql instances patch INSTANCE_NAME \
--backup-start-time 16:00

Jika patch memodifikasi nilai yang memerlukan proses mulai ulang, Anda akan melihat perintah untuk melanjutkan perubahan atau membatalkan.

Untuk mempelajari tanda konfigurasi instance lebih lanjut, baca artikel gcloud sql instances patch.

REST v1

Dengan menggunakan perintah ini, Anda dapat mengubah waktu mulai pencadangan.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID
  • INSTANCE_ID: ID instance
  • PRIVATE_NETWORK: jaringan yang Anda tambahkan atau pilih untuk membuat koneksi pribadi

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Meminta isi JSON:

{
  "settings": {
    "backupConfiguration": {
      "startTime": "16:00",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [],
      "ipv4Enabled": false,
    }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima JSON respons seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Jika patch mengubah nilai yang memerlukan proses mulai ulang, Anda akan melihat perintah untuk melanjutkan perubahan atau membatalkannya.

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

REST v1beta4

Dengan menggunakan perintah ini, Anda dapat mengubah waktu mulai pencadangan.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID
  • INSTANCE_ID: ID instance
  • PRIVATE_NETWORK: jaringan yang Anda tambahkan atau pilih untuk membuat koneksi pribadi

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Meminta isi JSON:

{
  "settings": {
    "backupConfiguration": {
      "startTime": "16:00",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [],
      "ipv4Enabled": false,
    }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima JSON respons seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Jika patch mengubah nilai yang memerlukan proses mulai ulang, Anda akan melihat perintah untuk melanjutkan perubahan atau membatalkan.

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

Mengedit instance dengan Private Service Connect yang diaktifkan

Anda dapat mengupdate instance dengan Private Service Connect yang diaktifkan menggunakan gcloud CLI atau API. Misalnya, Anda dapat mengupdate project yang terkait dengan instance untuk tujuan berikut:

  • Untuk mengizinkan koneksi dari endpoint Private Service Connect ke instance Cloud SQL.
  • Untuk menghapus project dari daftar project yang diizinkan. Untuk project yang dihapus, koneksi ke endpoint Private Service Connect yang ada akan terus berfungsi, tetapi endpoint baru tidak akan diterima.

gcloud

Untuk memperbarui project yang dapat menggunakan Private Service Connect, gunakan perintah gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--allowed-psc-projects=ALLOWED_PROJECTS

Lakukan penggantian berikut:

  • INSTANCE_NAME: nama instance Cloud SQL yang dapat dihubungkan dengan endpoint Private Service Connect di jaringan VPC.
  • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance yang dapat dihubungkan dengan endpoint Private Service Connect di jaringan VPC.
  • ALLOWED_PROJECTS: daftar project ID atau nomor yang diizinkan, dipisahkan koma. Project ini menggantikan project yang sudah dikonfigurasi untuk menggunakan Private Service Connect. Jika project tidak ada dalam daftar ini, Anda tidak dapat menggunakannya untuk membuat instance dan mengaktifkan Private Service Connect untuk project tersebut.

Contoh berikut memungkinkan dua project (98765 dan 87654) membuat koneksi dari endpoint Private Service Connect ke instance Cloud SQL myinstance yang dimuat dalam project 12345:

gcloud sql instances patch myinstance \
--project=12345 \
--allowed-psc-projects='98765','87654'

Untuk menghapus semua project yang diizinkan, gunakan perintah gcloud sql instances patch dan flag
--clear-allowed-psc-projects:

gcloud sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--clear-allowed-psc-projects

Flag ini memastikan tidak ada project yang diizinkan secara tidak sengaja.

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance yang dapat dihubungkan dengan endpoint Private Service Connect di jaringan VPC.
  • INSTANCE_NAME: nama instance Cloud SQL yang dapat dihubungkan dengan endpoint Private Service Connect di jaringan VPC.
  • ALLOWED_PROJECTS: daftar project ID atau nomor yang diizinkan, dipisahkan koma. Project ini menggantikan project yang sudah dikonfigurasi untuk menggunakan Private Service Connect. Jika project tidak ada dalam daftar ini, Anda tidak dapat menggunakannya untuk membuat instance dan mengaktifkan Private Service Connect untuk project tersebut.

Metode HTTP dan URL:

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

Meminta isi JSON:

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS]
      }
    },
    "kind": "sql#settings"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

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-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Untuk menghapus semua project yang diizinkan, gunakan flag clear-allowed-psc-projects. Flag ini memastikan tidak ada project yang diizinkan secara tidak sengaja.

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

REST v1beta4

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance yang dapat dihubungkan dengan endpoint Private Service Connect di jaringan VPC.
  • INSTANCE_NAME: nama instance Cloud SQL yang dapat dihubungkan dengan endpoint Private Service Connect di jaringan VPC.
  • ALLOWED_PROJECTS: daftar project ID atau nomor yang diizinkan, dipisahkan koma. Project ini menggantikan project yang sudah dikonfigurasi untuk menggunakan Private Service Connect. Jika project tidak ada dalam daftar ini, Anda tidak dapat menggunakannya untuk membuat instance dan mengaktifkan Private Service Connect untuk project tersebut.

Metode HTTP dan URL:

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

Meminta isi JSON:

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS]
      }
    },
    "kind": "sql#settings"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

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-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Untuk menghapus semua project yang diizinkan, gunakan flag clear-allowed-psc-projects. Flag ini memastikan tidak ada project yang diizinkan secara tidak sengaja.

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

Mengedit SAN kustom untuk instance

Jika Anda ingin menggunakan nama DNS kustom untuk terhubung ke instance Cloud SQL, bukan menggunakan alamat IP, konfigurasikan setelan nama alternatif subjek (SAN) kustom saat membuat instance. Nama DNS kustom yang Anda masukkan ke setelan SAN kustom akan ditambahkan ke kolom SAN sertifikat server instance. Hal ini memungkinkan Anda menggunakan nama DNS kustom dengan validasi nama host secara aman.

Anda dapat melakukan operasi berikut dengan SAN kustom untuk sertifikat server instance:

  • Menambahkan nama DNS ke instance: tambahkan daftar yang dipisahkan koma hingga tiga nama DNS kustom ke setelan SAN kustom. Cloud SQL menambahkan nama ini ke kolom SAN sertifikat server. Anda dapat mengamankan beberapa nama DNS dengan satu sertifikat.
  • Ubah nama DNS untuk instance: ubah nama DNS kustom yang ingin ditambahkan ke kolom SAN sertifikat server instance.
  • Menghapus nama DNS dari instance: hapus semua nama DNS kustom dari kolom SAN sertifikat server instance.

Anda dapat mengedit SAN kustom untuk instance menggunakan gcloud CLI atau API.

gcloud

Untuk mengedit SAN kustom untuk instance, gunakan perintah gcloud beta sql instances patch:

gcloud beta sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--custom-subject-alternative-names=DNS_NAMES

Lakukan penggantian berikut:

  • INSTANCE_NAME: nama instance Cloud SQL yang memiliki sertifikat server tempat Anda menambahkan, mengubah, atau menghapus nama DNS
  • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
  • DNS_NAMES: daftar yang dipisahkan koma yang berisi hingga tiga nama DNS yang Anda tambahkan ke sertifikat server instance Anda

Untuk menghapus semua nama DNS dari sertifikat server instance Cloud SQL, gunakan perintah gcloud beta sql instances patch dan flag
--clear-custom-subject-alternative-names:

gcloud beta sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--clear-custom-subject-alternative-names

Flag ini memastikan bahwa tidak ada nama DNS yang ditambahkan ke sertifikat secara tidak sengaja.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID atau nomor project project Google Cloud Anda. Project ini berisi instance Cloud SQL yang memiliki sertifikat server tempat Anda menambahkan, mengubah, atau menghapus nama DNS.
  • INSTANCE_NAME: nama instance.
  • DNS_NAMES: daftar yang dipisahkan koma yang berisi maksimum tiga nama DNS yang Anda tambahkan ke sertifikat server instance.

    Jika Anda sudah memiliki nama DNS yang ditambahkan ke sertifikat, dan Anda menggunakan parameter ini untuk menentukan nama DNS yang berbeda, Cloud SQL akan menghapus nama DNS asli dari sertifikat.

    Jika Anda tidak menentukan nama DNS apa pun untuk parameter customSubjectAlternativeNames, tetapi memberikan nilai [] null, Cloud SQL akan menghapus semua nama DNS dari sertifikat server instance. Hal ini memastikan bahwa tidak ada nama DNS yang ditambahkan ke sertifikat secara tidak sengaja.

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/sql/v1veta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Meminta isi JSON:

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "customSubjectAlternativeNames": "DNS_NAMES"
    },
    "kind": "sql#settings"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

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-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "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:patch.