パブリック IP を構成する

MySQL   |  PostgreSQL   |  SQL Server

ここでは、Cloud SQL インスタンスで使用するパブリック IP 接続を構成する方法を説明します。

はじめに

パブリック IPv4 アドレスを使用するように Cloud SQL インスタンスを構成し、特定の IP アドレスまたはアドレス範囲からの接続を受け入れるには、承認済みアドレスをインスタンスに追加します。

承認済みネットワークとしてプライベート ネットワーク（10.x.x.x など）を指定することはできません。

SQL Server インスタンスのパブリック IP アドレス:

• IPv6: インスタンスは IPv6 をサポートしていません。
• IPv4: インスタンスには静的 IPv4 アドレスが自動的に割り当てられます。インスタンスがオフ（非アクティブ）の間も常に、IP アドレスにわずかな料金がかかります。

IP 接続を使用して管理クライアントをインスタンスに接続する方法については、IP アドレスを使用して sqlcmd クライアントを接続するをご覧ください。

パブリック IP アドレスを使用して接続を受け入れるようにインスタンスを構成する場合は、SSL を使用してデータを保護するように構成する必要もあります。詳細については、インスタンス用に SSL を構成するをご覧ください。

公共のインターネットに公開されない IP アドレスでインスタンスを構成するには、プライベート IP 接続を構成するの手順を行います。

パブリック IP を有効にして、承認済みアドレスまたはアドレス範囲を追加する

インスタンスのパブリック IP を有効にすると、Cloud SQL は、公共のインターネットの静的な IPv4 アドレスを使用してインスタンスを構成します。パブリック IP を有効にしたら、データベース接続の承認を設定する必要があります。詳細については、承認のオプションをご覧ください。

パブリック IP を有効にして承認済みアドレスを追加するには:

Console

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

   Cloud SQL の [インスタンス] に移動

2. インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
3. SQL ナビゲーション メニューから [接続] を選択します。
4. [ネットワーキング] タブをクリックします。
5. [パブリック IP] チェックボックスをオンにします。
6. [ネットワークを追加] をクリックします。
7. 必要に応じて、[名前] フィールドにこのネットワークの名前を入力します。
8. [ネットワーク] フィールドに、接続を許可する IP アドレスまたはアドレス範囲を入力します。

   CIDR 表記を使用します。

9. [完了] をクリックします。
10. [保存] をクリックします。

gcloud

1. IPv4 アドレスをまだインスタンスに追加していない場合は、次のコマンドを使用して追加します。

   gcloud sql instances patch INSTANCE_NAME\
   --assign-ip
   

2. インスタンスを記述して、既存のすべての認可済みアドレスを表示します。

   gcloud sql instances describe INSTANCE_NAME
   

   ipConfiguration の下で authorizedNetwork エントリを探し、維持する承認済みアドレスをメモします。

3. 承認済みネットワークのリストを更新して、必要なすべてのアドレスを追加します。

   gcloud sql instances patch INSTANCE_NAME \
   --authorized-networks=IP_ADDR1,IP_ADDR2...
   

   CIDR 表記を使用します。

4. 変更を確定します。

   gcloud sql instances describe INSTANCE_NAME
   

承認済みアドレスを削除しても、そのアドレスからの既存の接続は切断されません。既存の接続を切断する場合は、インスタンスを再起動します。

すべての認可済みネットワークを削除するには、次のコマンドを使用します。

  gcloud sql instances patch INSTANCE_NAME --clear-authorized-networks
  

REST v1

1. インスタンスを記述して、既存のすべての認可済みアドレスを表示します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks": [],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

2. インスタンスに設定するすべてのアドレスが含まれるように、インスタンスを更新します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • network_range_1: 認可済みの IP アドレスまたは範囲
   • network_range_2: 別の認可済み IP アドレスまたは範囲

   HTTP メソッドと URL:

   PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

   リクエストの本文（JSON）:

   {
     "settings":
     {
       "ipConfiguration":
       {
         "authorizedNetworks":
           [{"value": "network_range_1"}, {"value": "network_range_2"}]
       }
     }
   }
   

   リクエストを送信するには、次のいずれかのオプションを開きます。

   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": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "operation-id",
     "targetId": "instance-id",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

   CIDR 表記を使用します。

3. 変更を確定します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • ip-address1: 最初の IP アドレスの CIDR 形式
   • ip-address-name1: 最初の IP アドレスの名前
   • ip-address2: 2 番目の IP アドレスの CIDR 形式
   • ip-address-name2: 2 番目の IP アドレスの名前
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type4",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks":
         [
           {
             "value": "ip-address1",
             "name": "ip-address-name1",
             "kind": "sql#aclEntry"
           },
           {
             "value": "ip-address2",
             "name": "ip-address-name2",
             "kind": "sql#aclEntry"
           }
         ],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

承認済みアドレスを削除しても、そのアドレスからの既存の接続は切断されません。既存の接続を切断する場合は、インスタンスを再起動します。

すべての認可済みネットワークを削除するには、次のコマンドを使用します。

  gcloud sql instances patch INSTANCE_NAME --clear-authorized-networks
  

Terraform

パブリック IP を有効にして承認済みのアドレスまたはアドレス範囲を追加するには、Terraform リソースを使用します。

resource "google_sql_database_instance" "sqlserver_public_ip_instance_name" {
  name             = "sqlserver-public-ip-instance-name"
  region           = "europe-west4"
  database_version = "SQLSERVER_2019_ENTERPRISE"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier              = "db-custom-2-7680"
    availability_type = "ZONAL"
    ip_configuration {
      # Add optional authorized networks
      # Update to match the customer's networks
      authorized_networks {
        name  = "test-net-3"
        value = "203.0.113.0/24"
      }
      # Enable public IP
      ipv4_enabled = true
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

変更を適用する

Google Cloud プロジェクトで Terraform 構成を適用するには、次のセクションの手順を完了します。

Cloud Shell を準備する

1. Cloud Shell を起動します。

2. Terraform 構成を適用するデフォルトの Google Cloud プロジェクトを設定します。

   このコマンドは、プロジェクトごとに 1 回だけ実行する必要があります。これは任意のディレクトリで実行できます。

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Terraform 構成ファイルに明示的な値を設定すると、環境変数がオーバーライドされます。

ディレクトリを準備する

Terraform 構成ファイルには独自のディレクトリ（ルート モジュールとも呼ばれます）が必要です。

1. Cloud Shell で、ディレクトリを作成し、そのディレクトリ内に新しいファイルを作成します。ファイル名の拡張子は .tf にする必要があります（例: main.tf）。このチュートリアルでは、このファイルを main.tf とします。

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. チュートリアルを使用している場合は、各セクションまたはステップのサンプルコードをコピーできます。

   新しく作成した main.tf にサンプルコードをコピーします。

   必要に応じて、GitHub からコードをコピーします。Terraform スニペットがエンドツーエンドのソリューションの一部である場合は、この方法をおすすめします。

3. 環境に適用するサンプル パラメータを確認し、変更します。
4. 変更を保存します。
5. Terraform を初期化します。これは、ディレクトリごとに 1 回だけ行います。

   terraform init

   最新バージョンの Google プロバイダを使用する場合は、-upgrade オプションを使用します。

   terraform init -upgrade

変更を適用する

1. 構成を確認して、Terraform が作成または更新するリソースが想定どおりであることを確認します。

   terraform plan

   必要に応じて構成を修正します。

2. 次のコマンドを実行します。プロンプトで「yes」と入力して、Terraform 構成を適用します。

   terraform apply

   Terraform に「Apply complete!」というメッセージが表示されるまで待ちます。

3. Google Cloud プロジェクトを開いて結果を表示します。Google Cloud コンソールの UI でリソースに移動して、Terraform によって作成または更新されたことを確認します。

注: Terraform のサンプルでは通常、必要な API が Google Cloud プロジェクトで有効になっていることを前提としています。

変更を削除する

変更を削除するには、次の操作を行います。

1. 削除の保護を無効にするには、Terraform 構成ファイルで deletion_protection 引数を false に設定します。

   deletion_protection =  "false"

2. 次のコマンドを実行します。プロンプトで「yes」と入力して、更新された Terraform 構成を適用します。

   terraform apply

3. 以前に Terraform 構成で適用されたリソースを削除するために、次のコマンドを実行してプロンプトで「yes」と入力します。

   terraform destroy

REST v1beta4

1. インスタンスを記述して、既存のすべての認可済みアドレスを表示します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks": [],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

2. インスタンスに設定するすべてのアドレスが含まれるように、インスタンスを更新します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • network_range_1: 認可済みの IP アドレスまたは範囲
   • network_range_2: 別の認可済み IP アドレスまたは範囲

   HTTP メソッドと URL:

   PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

   リクエストの本文（JSON）:

   {
     "settings":
     {
       "ipConfiguration":
       {
         "authorizedNetworks":
           [{"value": "network_range_1"}, {"value": "network_range_2"}]
       }
     }
   }
   

   リクエストを送信するには、次のいずれかのオプションを開きます。

   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/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": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "operation-id",
     "targetId": "instance-id",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

   CIDR 表記を使用します。

3. 変更を確定します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • ip-address1: 最初の IP アドレスの CIDR 形式
   • ip-address-name1: 最初の IP アドレスの名前
   • ip-address2: 2 番目の IP アドレスの CIDR 形式
   • ip-address-name2: 2 番目の IP アドレスの名前
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type4",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks":
         [
           {
             "value": "ip-address1",
             "name": "ip-address-name1",
             "kind": "sql#aclEntry"
           },
           {
             "value": "ip-address2",
             "name": "ip-address-name2",
             "kind": "sql#aclEntry"
           }
         ],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

承認済みアドレスを削除しても、そのアドレスからの既存の接続は切断されません。既存の接続を切断する場合は、インスタンスを再起動します。

すべての認可済みネットワークを削除するには、次のコマンドを使用します。

  gcloud sql instances patch INSTANCE_NAME --clear-authorized-networks
  

承認済みアドレスまたはアドレス範囲を削除する

承認済みアドレスを削除するには:

Console

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

   Cloud SQL の [インスタンス] に移動

2. インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
3. SQL ナビゲーション メニューから [接続] を選択します。
4. 削除するアドレスの削除アイコン をクリックします。
5. [保存] をクリックしてインスタンスを更新します。

gcloud

1. インスタンスを記述して、既存のすべての認可済みアドレスを表示します。

   gcloud sql instances describe INSTANCE_NAME
   

   ipConfiguration の下で authorizedNetwork エントリを探し、維持する承認済みアドレスをメモします。

2. 承認済みネットワーク リストを更新し、削除するアドレスを削除します。

   gcloud sql instances patch INSTANCE_NAME \
   --authorized-networks=IP_ADDR1,IP_ADDR2...
   

3. 変更を確定します。

   gcloud sql instances describe INSTANCE_NAME
   

REST v1

1. インスタンスを記述して、既存のすべての認可済みアドレスを表示します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • ip-address1: 最初の IP アドレスの CIDR 形式
   • ip-address-name1: 最初の IP アドレスの名前
   • ip-address2: 2 番目の IP アドレスの CIDR 形式
   • ip-address-name2: 2 番目の IP アドレスの名前
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type4",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks":
         [
           {
             "value": "ip-address1",
             "name": "ip-address-name1",
             "kind": "sql#aclEntry"
           },
           {
             "value": "ip-address2",
             "name": "ip-address-name2",
             "kind": "sql#aclEntry"
           }
         ],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

2. 保持するすべてのアドレスを含め、削除するすべてのアドレスを削除して、インスタンスを更新します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • network_range_1: 削除する認可済み IP アドレスまたはネットワーク範囲

   HTTP メソッドと URL:

   PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

   リクエストの本文（JSON）:

   {
     "settings":
     {
       "ipConfiguration":
       {
         "authorizedNetworks":
           [{"value": "network_range_1"}]
       }
     }
   }
   
   

   リクエストを送信するには、次のいずれかのオプションを開きます。

   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": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "operation-id",
     "targetId": "instance-id",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

3. 変更を確定します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • ip-address: IP アドレスの CIDR 形式
   • ip-address-name: IP アドレスの名前
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks":
         [
           {
             "value": "ip-address",
             "name": "ip-address-name",
             "kind": "sql#aclEntry"
           }
         ],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

REST v1beta4

1. インスタンスを記述して、既存のすべての認可済みアドレスを表示します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • ip-address1: 最初の IP アドレスの CIDR 形式
   • ip-address-name1: 最初の IP アドレスの名前
   • ip-address2: 2 番目の IP アドレスの CIDR 形式
   • ip-address-name2: 2 番目の IP アドレスの名前
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type4",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks":
         [
           {
             "value": "ip-address1",
             "name": "ip-address-name1",
             "kind": "sql#aclEntry"
           },
           {
             "value": "ip-address2",
             "name": "ip-address-name2",
             "kind": "sql#aclEntry"
           }
         ],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

2. 保持するすべてのアドレスを含め、削除するすべてのアドレスを削除して、インスタンスを更新します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • network_range_1: 削除する認可済み IP アドレスまたはネットワーク範囲

   HTTP メソッドと URL:

   PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

   リクエストの本文（JSON）:

   {
     "settings":
     {
       "ipConfiguration":
       {
         "authorizedNetworks":
           [{"value": "network_range_1"}]
       }
     }
   }
   
   

   リクエストを送信するには、次のいずれかのオプションを開きます。

   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/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": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "operation-id",
     "targetId": "instance-id",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

3. 変更を確定します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • ip-address: IP アドレスの CIDR 形式
   • ip-address-name: IP アドレスの名前
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks":
         [
           {
             "value": "ip-address",
             "name": "ip-address-name",
             "kind": "sql#aclEntry"
           }
         ],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

承認済みアドレスを削除しても、そのアドレスからの既存の接続は切断されません。既存の接続を切断する場合は、インスタンスを再起動します。

すべての認可済みネットワークを削除するには、次のコマンドを使用します。

  gcloud sql instances patch INSTANCE_NAME --clear-authorized-networks
  

すべてのパブリック IP 接続を拒否するようにインスタンスを構成する

すべてのパブリック IP 接続を拒否するようにインスタンスを構成するには:

Console

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

   Cloud SQL の [インスタンス] に移動

2. インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
3. SQL ナビゲーション メニューから [接続] を選択します。
4. 承認済みのすべてのアドレスの削除アイコン をクリックします。
5. [保存] をクリックしてインスタンスを更新します。

gcloud

1. 認可済みアドレスリストをクリアします。

   gcloud sql instances patch INSTANCE_NAME \
   --clear-authorized-networks
   

2. 変更を確定します。

   gcloud sql instances describe INSTANCE_NAME
   

REST v1

1. インスタンスを記述して、既存のすべての認可済みアドレスを表示します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • ip-address1: 最初の IP アドレスの CIDR 形式
   • ip-address-name1: 最初の IP アドレスの名前
   • ip-address2: 2 番目の IP アドレスの CIDR 形式
   • ip-address-name2: 2 番目の IP アドレスの名前
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type4",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks":
         [
           {
             "value": "ip-address1",
             "name": "ip-address-name1",
             "kind": "sql#aclEntry"
           },
           {
             "value": "ip-address2",
             "name": "ip-address-name2",
             "kind": "sql#aclEntry"
           }
         ],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

2. インスタンスを空のアドレスリストで更新します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID

   HTTP メソッドと URL:

   PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

   リクエストの本文（JSON）:

   {
     "settings":
     {
       "ipConfiguration":
       {
         "authorizedNetworks": []
       }
     }
   }
   

   リクエストを送信するには、次のいずれかのオプションを開きます。

   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": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "operation-id",
     "targetId": "instance-id",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

3. 変更を確定します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks": [],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

REST v1beta4

1. インスタンスを記述して、既存のすべての認可済みアドレスを表示します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • ip-address1: 最初の IP アドレスの CIDR 形式
   • ip-address-name1: 最初の IP アドレスの名前
   • ip-address2: 2 番目の IP アドレスの CIDR 形式
   • ip-address-name2: 2 番目の IP アドレスの名前
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type4",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks":
         [
           {
             "value": "ip-address1",
             "name": "ip-address-name1",
             "kind": "sql#aclEntry"
           },
           {
             "value": "ip-address2",
             "name": "ip-address-name2",
             "kind": "sql#aclEntry"
           }
         ],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

2. インスタンスを空のアドレスリストで更新します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID

   HTTP メソッドと URL:

   PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

   リクエストの本文（JSON）:

   {
     "settings":
     {
       "ipConfiguration":
       {
         "authorizedNetworks": []
       }
     }
   }
   

   リクエストを送信するには、次のいずれかのオプションを開きます。

   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/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": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "operation-id",
     "targetId": "instance-id",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

3. 変更を確定します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks": [],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

承認済みアドレスを削除しても、そのアドレスからの既存の接続は切断されません。既存の接続を切断する場合は、インスタンスを再起動します。

すべての認可済みネットワークを削除するには、次のコマンドを使用します。

  gcloud sql instances patch INSTANCE_NAME --clear-authorized-networks
  

パブリック IP を無効にする

パブリック IP を無効にできますが、プライベート IP も使用するようにインスタンスが構成されている場合に限られます。プライベート IP を有効にするには、プライベート IP を使用するように既存のインスタンスを構成するをご覧ください。

注: インスタンスのパブリック IP を無効にすると、インスタンスに割り当てられた IPv4 アドレスが解放されます。 このインスタンスのパブリック IP を後で再び有効にした場合は、別の IPv4 アドレスが取得されるので、パブリック IP アドレスを使用してこのインスタンスに接続するすべてのアプリケーションを変更する必要があります。

パブリック IP を無効にするには:

Console

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

   Cloud SQL の [インスタンス] に移動

2. インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
3. SQL ナビゲーション メニューから [接続] を選択します。
4. [パブリック IP] チェックボックスをオフにします。
5. [保存] をクリックしてインスタンスを更新します。

gcloud

1. インスタンスを更新します。

   gcloud sql instances patch INSTANCE_NAME \
   --no-assign-ip
   

2. 変更を確定します。

   gcloud sql instances describe INSTANCE_NAME
   

REST v1

1. インスタンスを記述して、既存のすべての認可済みアドレスを表示します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • ip-address1: 最初の IP アドレスの CIDR 形式
   • ip-address-name1: 最初の IP アドレスの名前
   • ip-address2: 2 番目の IP アドレスの CIDR 形式
   • ip-address-name2: 2 番目の IP アドレスの名前
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type4",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks":
         [
           {
             "value": "ip-address1",
             "name": "ip-address-name1",
             "kind": "sql#aclEntry"
           },
           {
             "value": "ip-address2",
             "name": "ip-address-name2",
             "kind": "sql#aclEntry"
           }
         ],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

2. インスタンスを更新します。

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

   • PROJECT_ID:: プロジェクト ID
   • INSTANCE_ID:: インスタンス ID
   • VPC_NETWORK_NAME:: このインスタンスに使用する Virtual Private Cloud（VPC）ネットワークの名前を指定します。このネットワークに対して、プライベート サービス アクセスがすでに構成されている必要があります。
   • RANGE_NAME:: 省略可。指定すると、IP 範囲が割り振られている範囲名が設定されます。範囲名は RFC-1035 を遵守し、1～63 文字にする必要があります。
   • AUTHORIZED_NETWORKS: パブリック IP 接続の場合は、インスタンスに接続できる承認済みネットワークからの接続を指定します。

   インスタンスにパブリック IP アドレスを使用する場合は、ipv4Enabled パラメータに true を設定します。インスタンスにプライベート IP アドレスを使用する場合は false を設定します。

   HTTP メソッドと URL:

   POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

   リクエストの本文（JSON）:

   {
     "name": "INSTANCE_ID",
     "region": "region",
     "databaseVersion": "database-version",
     "settings": {
       "tier": "machine-type",
       "ipConfiguration": {
         "ipv4Enabled": false,
         "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
         "allocatedIpRange": "RANGE_NAME"
         "authorizedNetworks": [AUTHORIZED_NETWORKS],
         
       }
     }
   }
   

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

   curl -X POST \
        -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"

   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 POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "OPERATION_ID",
     "targetId": "INSTANCE_ID",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
     "targetProject": "PROJECT_ID"
   }
   

3. 変更を確定します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks": [],
         "ipv4Enabled": false
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

REST v1beta4

1. インスタンスを記述して、既存のすべての認可済みアドレスを表示します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • ip-address1: 最初の IP アドレスの CIDR 形式
   • ip-address-name1: 最初の IP アドレスの名前
   • ip-address2: 2 番目の IP アドレスの CIDR 形式
   • ip-address-name2: 2 番目の IP アドレスの名前
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type4",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks":
         [
           {
             "value": "ip-address1",
             "name": "ip-address-name1",
             "kind": "sql#aclEntry"
           },
           {
             "value": "ip-address2",
             "name": "ip-address-name2",
             "kind": "sql#aclEntry"
           }
         ],
         "ipv4Enabled": true
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

2. インスタンスを更新します。

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

   • PROJECT_ID:: プロジェクト ID
   • INSTANCE_ID:: インスタンス ID
   • VPC_NETWORK_NAME:: このインスタンスに使用する Virtual Private Cloud（VPC）ネットワークの名前を指定します。このネットワークに対して、プライベート サービス アクセスがすでに構成されている必要があります。
   • RANGE_NAME:: 省略可。指定すると、IP 範囲が割り振られている範囲名が設定されます。範囲名は RFC-1035 を遵守し、1～63 文字にする必要があります。
   • AUTHORIZED_NETWORKS: パブリック IP 接続の場合は、インスタンスに接続できる承認済みネットワークからの接続を指定します。

   インスタンスにパブリック IP アドレスを使用する場合は、ipv4Enabled パラメータに true を設定します。インスタンスにプライベート IP アドレスを使用する場合は false を設定します。

   HTTP メソッドと URL:

   POST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances

   リクエストの本文（JSON）:

   {
     "name": "INSTANCE_ID",
     "region": "region",
     "databaseVersion": "database-version",
     "settings": {
       "tier": "machine-type",
       "ipConfiguration": {
         "ipv4Enabled": false,
         "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
         "allocatedIpRange": "RANGE_NAME"
         "authorizedNetworks": [AUTHORIZED_NETWORKS],
         
       }
     }
   }
   

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances"

   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 POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "OPERATION_ID",
     "targetId": "INSTANCE_ID",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
     "targetProject": "PROJECT_ID"
   }
   

3. 変更を確定します。

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

   • project-id: プロジェクト ID
   • instance-id: インスタンス ID
   • machine-type: インスタンスのマシンタイプ
   • zone: インスタンス ゾーン

   HTTP メソッドと URL:

   GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

   リクエストを送信するには、次のいずれかのオプションを開きます。

   curl（Linux、macOS、Cloud Shell）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings"

   PowerShell（Windows）

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri " https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings" | Select-Object -Expand Content

   次のような JSON レスポンスが返されます。

   レスポンス

   {
     "settings":
     {
       "authorizedGaeApplications": [],
       "tier": "machine-type",
       "kind": "sql#settings",
       "availabilityType": "REGIONAL",
       "pricingPlan": "PER_USE",
       "replicationType": "SYNCHRONOUS",
       "activationPolicy": "ALWAYS",
       "ipConfiguration":
       {
         "privateNetwork": "projects/project-id/global/networks/default",
         "authorizedNetworks": [],
         "ipv4Enabled": false
       },
       "locationPreference":
       {
         "zone": "zone",
         "kind": "sql#locationPreference"
       },
       "dataDiskType": "PD_SSD",
       "maintenanceWindow":
       {
         "kind": "sql#maintenanceWindow",
         "hour": 0,
         "day": 0
       },
       "backupConfiguration":
       {
         "startTime": "03:00",
         "kind": "sql#backupConfiguration",
         "enabled": true,
         "binaryLogEnabled": true
       },
       "settingsVersion": "54",
       "storageAutoResizeLimit": "0",
       "storageAutoResize": true,
       "dataDiskSizeGb": "10"
     }
   }
   

トラブルシューティング

問題	トラブルシューティング
Aborted connection.	次のような問題が考えられます。 ネットワークが不安定。 TCP keep-alive コマンドに応答しない（クライアントまたはサーバーのいずれかが応答しないか、過負荷の可能性があります）。 データベース エンジン接続の存続期間を超えたため、サーバーが接続を終了している。 アプリケーションは、接続プールや再試行などのベスト プラクティスに従ってネットワーク障害に対応する必要があります。通常、可能であれば、これらのエラーが接続プーラーによって検出されます。エラーが検出されない場合、アプリケーションは、再試行するか安全に失敗する必要があります。 接続の再試行には、次の方法をおすすめします。 指数バックオフ。再試行の間隔を指数関数的に増やします。 ランダム化されたバックオフも追加します。 これらの方法を組み合わせると、スロットリングが減ります。

次のステップ

• データベース接続の認可を設定する。詳しくは、認可のオプションをご覧ください。
• インスタンスの SSL 鍵を作成して管理する。
• 管理クライアントをインスタンスに接続する。