Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

編輯執行個體

MySQL | PostgreSQL | SQL Server

本頁面說明如何編輯現有的 Cloud SQL 執行個體。

建立執行個體後，您可以在執行個體運作時編輯設定。如要瞭解執行個體設定，以及變更設定對執行個體的影響，請參閱「執行個體設定」。

您可以將 SQL Server 適用的 Cloud SQL 與 Managed Service for Microsoft Active Directory (Managed Microsoft AD) 整合。這項整合功能可讓您在個別執行個體層級加入及退出 Managed Microsoft AD 網域。詳情請參閱「Cloud SQL 的 Microsoft AD 代管服務總覽」。

您也可以啟用或停用資料庫稽核功能。

編輯執行個體

大多數編輯內容只能在執行個體運作時套用。

控制台

前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面
點選執行個體名稱，開啟執行個體的「總覽」頁面。
按一下 [編輯]。
在「Customize your instance」(自訂執行個體) 部分，如果出現「Show configuration options」(顯示設定選項) 選單，請按一下該選單。
更新執行個體的任何可編輯設定。

進一步瞭解執行個體設定。
按一下「儲存」。

gcloud

這個指令會修改備份開始時間。

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

如果修補程式修改的值需要重新啟動，系統會提示您繼續變更或取消。

如要進一步瞭解執行個體設定旗標，請參閱「gcloud sql instances patch」。

REST v1

您可以使用這個指令修改備份開始時間。

使用任何要求資料之前，請先修改下列項目的值：

PROJECT_ID：專案 ID
INSTANCE_ID：執行個體 ID
PRIVATE_NETWORK：您要新增或選取來建立私人連線的網路

HTTP 方法和網址：

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

JSON 要求主體：

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

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

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/instances/INSTANCE_ID"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$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/instances/INSTANCE_ID" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "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"
}

如果修補程式修改的值需要重新啟動，系統會提示您繼續變更或取消。

如要瞭解如何為這項工作建構基礎 REST API 要求，請參閱 instances:patch 頁面上的 APIs Explorer。

REST v1beta4

您可以使用這個指令修改備份開始時間。

使用任何要求資料之前，請先修改下列項目的值：

PROJECT_ID：專案 ID
INSTANCE_ID：執行個體 ID
PRIVATE_NETWORK：您要新增或選取來建立私人連線的網路

HTTP 方法和網址：

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

JSON 要求主體：

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

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

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/instances/INSTANCE_ID"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$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/instances/INSTANCE_ID" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "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"
}

如果修補程式修改的值需要重新啟動，系統會提示您繼續變更或取消。

如要瞭解如何為這項工作建構基礎 REST API 要求，請參閱 instances:patch 頁面上的 APIs Explorer。

編輯已啟用 Private Service Connect 的執行個體

您可以使用 gcloud CLI 或 API，更新已啟用 Private Service Connect 的執行個體。舉例來說，您可以基於下列目的，更新與執行個體相關聯的專案：

允許從 Private Service Connect 端點連線至 Cloud SQL 執行個體。
2026 年 8 月起，所有建立、複製的 Cloud SQL 執行個體，以及啟用的 Private Service Connect，都會預設啟用連線協調行為，且無法停用。從允許的專案清單中移除專案後，該專案現有的所有 Private Service Connect 連線會立即關閉 (協調)。這表示在這些已移除的專案中，使用 Private Service Connect 端點的應用程式無法繼續透過這些端點連線。對於 2026 年 8 月前建立的執行個體，如果您從允許清單中移除專案，在您手動移除端點前，這些專案中採用 Private Service Connect 端點的應用程式仍會繼續連線。

gcloud

如要更新可使用 Private Service Connect 的專案，請使用 gcloud sql instances patch 指令：

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

請依指示取代下列項目：

INSTANCE_NAME：Cloud SQL 執行個體名稱，虛擬私有雲網路中的 Private Service Connect 端點可連至該執行個體。
PROJECT_ID： Google Cloud 專案的 ID 或專案編號，該專案包含虛擬私有雲網路中 Private Service Connect 端點可連線的執行個體。
ALLOWED_PROJECTS：允許的專案 ID 或編號清單，以半形逗號分隔。這些專案會覆寫已設為使用 Private Service Connect 的專案。如果專案不在這份清單中，就無法用來建立執行個體，並為執行個體啟用 Private Service Connect。

以下範例允許兩個專案 (98765 和 87654)，從 Private Service Connect 端點連線至 12345 專案中的 myinstance Cloud SQL 執行個體：

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

如要移除所有允許的專案，請使用 gcloud sql instances patch 指令和
--clear-allowed-psc-projects 旗標：

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

這個旗標可確保不會不小心允許任何專案。

REST v1

使用任何要求資料之前，請先修改下列項目的值：

PROJECT_ID： Google Cloud 專案的 ID 或專案編號，該專案包含虛擬私有雲網路中 Private Service Connect 端點可連線的執行個體。
INSTANCE_NAME：Cloud SQL 執行個體名稱，虛擬私有雲網路中的 Private Service Connect 端點可連至該執行個體。
ALLOWED_PROJECTS：允許的專案 ID 或編號清單，以半形逗號分隔。這些專案會覆寫已設為使用 Private Service Connect 的專案。如果專案不在這份清單中，就無法用來建立執行個體，並為執行個體啟用 Private Service Connect。

HTTP 方法和網址：

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

JSON 要求主體：

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

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

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/instances/INSTANCE_NAME"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$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/instances/INSTANCE_NAME" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "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"
}

如要移除所有允許的專案，請使用 clear-allowed-psc-projects 旗標。這個旗標可確保不會不小心允許任何專案。

如要瞭解如何為這項工作建構基礎 REST API 要求，請參閱 instances:patch 頁面上的 APIs Explorer。

REST v1beta4

使用任何要求資料之前，請先修改下列項目的值：

PROJECT_ID： Google Cloud 專案的 ID 或專案編號，該專案包含虛擬私有雲網路中 Private Service Connect 端點可連線的執行個體。
INSTANCE_NAME：Cloud SQL 執行個體名稱，虛擬私有雲網路中的 Private Service Connect 端點可連至該執行個體。
ALLOWED_PROJECTS：允許的專案 ID 或編號清單，以半形逗號分隔。這些專案會覆寫已設為使用 Private Service Connect 的專案。如果專案不在這份清單中，就無法用來建立執行個體，並為執行個體啟用 Private Service Connect。

HTTP 方法和網址：

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

JSON 要求主體：

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

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

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/instances/INSTANCE_NAME"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$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/instances/INSTANCE_NAME" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "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"
}

如要移除所有允許的專案，請使用 clear-allowed-psc-projects 旗標。這個旗標可確保不會不小心允許任何專案。

如要瞭解如何為這項工作建構基礎 REST API 要求，請參閱 instances:patch 頁面上的 APIs Explorer。

編輯執行個體的伺服器 CA 模式

您可以變更執行個體的伺服器憑證授權單位 (CA) 模式，改用共用 CA (GOOGLE_MANAGED_CAS_CA) 或客戶自行管理的 CA (CUSTOMER_MANAGED_CAS_CA)。

您無法將執行個體變更為使用個別執行個體 CA (GOOGLE_MANAGED_INTERNAL_CA) 選項，這是預設設定。

如要進一步瞭解不同的伺服器 CA 模式選項，請參閱「憑證授權單位 (CA) 階層」。

更新執行個體，改用共用 CA 或客戶自行管理的 CA 之前，請先完成下列步驟：

請查看不支援連線至 Cloud SQL 執行個體的 Google Cloud 服務清單，這些執行個體已設為使用共用 CA 或客戶自行管理的 CA。如果部署作業必須使用該服務，您可能需要延後更新。
如果您使用 Cloud SQL Auth Proxy 或任何 Cloud SQL 語言連接器連線至執行個體，請確認這些工具的版本符合最低要求。如要使用共用 CA，您必須使用 Cloud SQL Auth Proxy 2.13.0 以上版本；如要使用客戶自行管理的 CA，則須使用 Cloud SQL Auth Proxy 2.14.3 以上版本。如要瞭解 Cloud SQL 語言連接器的最低版本需求，請參閱「Cloud SQL 語言連接器需求」。
如要改用共用 CA，請下載全球和區域 CA 組合，並複製到資料庫用戶端，讓用戶端信任這些 CA。在切換伺服器 CA 模式設定前設定憑證，有助於避免資料庫用戶端可能中斷。
如要改用客戶自行管理的 CA，請按照下列步驟操作：
- 請確認您已建立 CA 集區，並為服務帳戶提供 CA 集區的存取權。
- 確認 CA 集區中至少有一個 CA。
- 為避免更新後發生中斷情形，請從客戶自行管理的 CA 下載憑證，並將資料庫用戶端設為信任您的 CA。

控制台

前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面
點選執行個體名稱，開啟執行個體的「總覽」頁面。
按一下 [編輯]。
在「自訂執行個體」部分，展開「顯示設定選項」。
點按「安全性」。
在「Server certificate authority mode」(伺服器憑證授權單位模式) 專區，選取「Google managed CAS certificate authority」(Google 代管的 CAS 憑證授權單位)。
選用：如要啟用伺服器憑證自動輪換功能，請勾選「自動輪換伺服器憑證」核取方塊。
按一下「儲存」。

如要將執行個體從使用個別執行個體 CA 或共用 CA，更新為使用客戶自行管理的 CA，請參閱「使用客戶自行管理的 CA」。

gcloud

如要將執行個體從使用個別執行個體 CA 更新為共用 CA，請執行下列指令：

gcloud sql instances patch INSTANCE_NAME \
--server-ca-mode=GOOGLE_MANAGED_CAS_CA

替換 INSTANCE_NAME：要修補的 Cloud SQL 執行個體名稱。

為 --server-ca-mode 旗標指定 GOOGLE_MANAGED_CAS_CA。

如要將執行個體從使用個別執行個體 CA 或共用 CA，更新為使用客戶自行管理的 CA，請參閱「使用客戶自行管理的 CA」。

REST

如要將執行個體從使用個別執行個體 CA 更新為共用 CA，請使用 instances.patch 方法並指定下列屬性：

使用任何要求資料之前，請先修改下列項目的值：

PROJECT_ID：Cloud SQL 執行個體所在專案的 ID。
INSTANCE_ID：要修補的 Cloud SQL 執行個體名稱。

HTTP 方法和網址：

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

JSON 要求主體：

{
  "settings":{
     "ipConfiguration":
      {
         "serverCaMode": "GOOGLE_MANAGED_CAS_CA"
      }
   }
}

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

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/instances/INSTANCE_ID"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$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/instances/INSTANCE_ID" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-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"
}

如要將執行個體從使用個別執行個體 CA 或共用 CA，更新為使用客戶自行管理的 CA，請參閱「使用客戶自行管理的 CA」。

編輯執行個體的自訂 SAN

如要使用自訂 DNS 名稱 (而非 IP 位址) 連線至 Cloud SQL 執行個體，請在建立執行個體時，設定自訂主體別名 (SAN)。您在自訂 SAN 設定中插入的自訂 DNS 名稱，會新增至執行個體伺服器憑證的 SAN 欄位。這樣一來，您就能安全地使用自訂 DNS 名稱和主機名稱驗證。

您可以對執行個體伺服器憑證的自訂 SAN 執行下列作業：

在執行個體中新增 DNS 名稱：在自訂 SAN 設定中，新增最多三個自訂 DNS 名稱，並以逗號分隔。Cloud SQL 會將這些名稱新增至伺服器憑證的 SAN 欄位。您可以使用單一憑證保護多個 DNS 名稱。
修改執行個體的 DNS 名稱：變更要新增至執行個體伺服器憑證 SAN 欄位的自訂 DNS 名稱。
從執行個體中移除 DNS 名稱：從執行個體伺服器憑證的 SAN 欄位中，移除所有自訂 DNS 名稱。

您可以使用 gcloud CLI 或 API，編輯執行個體的自訂 SAN。

gcloud

如要編輯執行個體的自訂 SAN，請使用 gcloud sql instances patch 指令：

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

請依指示取代下列項目：

INSTANCE_NAME：Cloud SQL 執行個體的名稱，該執行個體具備您要新增、修改或移除 DNS 名稱的伺服器憑證
PROJECT_ID： Google Cloud 專案的 ID 或專案編號，該專案包含執行個體
DNS_NAMES：以逗號分隔的清單，最多包含三個 DNS 名稱，可新增至執行個體的伺服器憑證。
注意：如果您已將 DNS 名稱新增至憑證，並使用這個參數指定不同的 DNS 名稱，Cloud SQL 會從憑證中移除原始 DNS 名稱。

如要從 Cloud SQL 執行個體的伺服器憑證中移除所有 DNS 名稱，請使用 gcloud sql instances patch 指令和
--clear-custom-subject-alternative-names 旗標：

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

這個旗標可確保不會不小心將 DNS 名稱新增至憑證。

REST

使用任何要求資料之前，請先修改下列項目的值：

PROJECT_ID： Google Cloud 專案的 ID 或專案編號。這項專案含有 Cloud SQL 執行個體，其伺服器憑證的 DNS 名稱將新增、修改或移除。
INSTANCE_NAME：執行個體的名稱。
DNS_NAMES：以半形逗號分隔的清單，最多可列出三個要新增至執行個體伺服器憑證的 DNS 名稱。

如果您已將 DNS 名稱新增至憑證，並使用這個參數指定其他 DNS 名稱，Cloud SQL 會從憑證中移除原始 DNS 名稱。

如果您未指定 customSubjectAlternativeNames 參數的任何 DNS 名稱，而是提供空值 []，Cloud SQL 就會從執行個體的伺服器憑證中移除所有 DNS 名稱。這樣可以確保不會不小心將 DNS 名稱新增至憑證。

HTTP 方法和網址：

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

JSON 要求主體：

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

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

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/v1veta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$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/v1veta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "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"
}

如要瞭解如何建構這項工作的基礎 REST API 要求，請參閱 instances:patch 頁面上的 APIs Explorer。

後續步驟

執行個體設定簡介

編輯執行個體 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

編輯執行個體

控制台

gcloud

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

編輯已啟用 Private Service Connect 的執行個體

gcloud

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

編輯執行個體的伺服器 CA 模式

控制台

gcloud

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

編輯執行個體的自訂 SAN

gcloud

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

後續步驟

編輯執行個體