インスタンスの編集

MySQL | PostgreSQL | SQL Server

このページでは、既存の Cloud SQL インスタンスを編集する方法について説明します。

インスタンスの作成後、そのインスタンスの実行中に編集して設定を変更できます。インスタンスの設定と、設定の変更によるインスタンスへの影響については、インスタンスの設定をご覧ください。

Cloud SQL for SQL Server は、Managed Service for Microsoft Active Directory（マネージド Microsoft AD）と統合できます。統合には、Managed Microsoft AD ドメインをインスタンスごとに参加および離脱させる機能が含まれます。詳細については、Cloud SQL におけるマネージド Microsoft AD の概要をご覧ください。

データベースの監査を有効または無効にすることもできます。

インスタンスの編集

ほとんどの編集は、実行中のインスタンスにのみ適用できます。

コンソール

Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

Cloud SQL の [インスタンス] に移動
インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
[編集] をクリックします。
[インスタンスのカスタマイズ] セクションで [構成オプションを表示] メニューが表示されたら、それをクリックします。
インスタンスで編集可能な設定を更新します。

詳しくは、インスタンスの設定をご覧ください。
[保存] をクリックします。

gcloud

このコマンドは、バックアップの開始時刻を変更します。

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

再起動が必要な値を変更した場合、変更の続行またはキャンセルの選択を求められます。

インスタンス構成フラグの詳細については、gcloud SQL インスタンスのパッチをご覧ください。

REST v1

次のコマンドでは、バックアップの開始時刻が変更されます。

リクエストのデータを使用する前に、次のように置き換えます。

project-id: プロジェクト ID。
instance-id: インスタンス ID。
private-network: プライベート接続の作成のために追加または選択するネットワーク。

HTTP メソッドと URL:

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）

リクエスト本文を 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 v1beta4

次のコマンドでは、バックアップの開始時刻が変更されます。

リクエストのデータを使用する前に、次のように置き換えます。

project-id: プロジェクト ID。
instance-id: インスタンス ID。
private-network: プライベート接続の作成のために追加または選択するネットワーク。

HTTP メソッドと URL:

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）

リクエスト本文を 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 リクエストがどのように作成されるかについては、API Explorer の Instances: patch ページをご覧ください。