修改实例

MySQL | PostgreSQL | SQL Server

本页介绍如何修改现有 Cloud SQL 实例。

创建实例后，您可以在实例运行时对其进行修改以更改其设置。如需了解实例设置以及更改此类设置对实例的影响，请参阅实例设置。

修改实例

大多数修改都只能应用于运行中的实例。

控制台

在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。

转到“Cloud SQL 实例”
如需打开实例的概览页面，请点击实例名称。
点击修改。
在自定义实例部分中，如果系统显示显示配置选项菜单，则点击该菜单。
更新实例的所有可编辑设置。

详细了解实例设置。
点击保存。

gcloud

此命令会修改备份开始时间。

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

此命令允许其他 Google Cloud 服务（例如 BigQuery）访问 Cloud SQL 中的数据，并通过内部连接对此数据进行查询。

gcloud sql instances patch INSTANCE_NAME \
--enable-google-private-path

如果补丁修改的值需要重启实例，系统将提示您继续进行更改或取消操作。

如需详细了解实例配置标志，请参阅 gcloud sql instances patch。

REST v1

通过使用此命令，您可以修改备份开始时间，允许其他 Google Cloud 服务（如 BigQuery）访问 Cloud SQL 中的数据，并通过内部连接对此数据进行查询。

在使用任何请求数据之前，请先进行以下替换：

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,
      "enablePrivatePathForGoogleCloudServices": true
    }
}

如需发送您的请求，请展开以下选项之一：

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

通过使用此命令，您可以修改备份开始时间，允许其他 Google Cloud 服务（如 BigQuery）访问 Cloud SQL 中的数据，并通过内部连接对此数据进行查询。

在使用任何请求数据之前，请先进行以下替换：

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,
      "enablePrivatePathForGoogleCloudServices": true
    }
}

如需发送您的请求，请展开以下选项之一：

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 实例。
从允许的项目列表中移除项目。对于任何已移除的项目，与任何现有 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：VPC 网络中的 Private Service Connect 端点可以连接到的 Cloud SQL 实例的名称。
PROJECT_ID：Google Cloud 项目的 ID 或项目编号，该项目包含 VPC 网络中的 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 或项目编号，该项目包含 VPC 网络中的 Private Service Connect 端点可以连接到的实例。
INSTANCE_NAME：VPC 网络中的 Private Service Connect 端点可以连接到的 Cloud SQL 实例的名称。
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 或项目编号，该项目包含 VPC 网络中的 Private Service Connect 端点可以连接到的实例。
INSTANCE_NAME：VPC 网络中的 Private Service Connect 端点可以连接到的 Cloud SQL 实例的名称。
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。