インスタンスを作成する

このページでは、Cloud SQL for MySQL インスタンス（第 1 世代または第 2 世代）を作成する方法を説明します。

すべてのインスタンスの設定について詳しくは、インスタンスの設定をご覧ください。

第 2 世代のインスタンスを作成する

第 2 世代インスタンスを作成するには:

Console（第 2 世代）

Google Cloud Console の Cloud SQL インスタンスページに移動します。
[Cloud SQL インスタンス] ページに移動
[インスタンスを作成] をクリックします。
[MySQL] を選択して [次へ] をクリックします。
名前を入力します。

インスタンス名には機密情報や個人を特定できる情報を含めないでください。インスタンス名は外部から閲覧可能です。

インスタンス名にプロジェクト ID を含める必要はありません。この処理は必要に応じて自動的に行われます（ログファイルの場合など）。

注: 削除したインスタンスのインスタンス名は、削除してから 1 週間過ぎるまで再利用できません。
'root'@'%' ユーザーのパスワードを入力します。
インスタンスのリージョンを設定します。
インスタンスにアクセスするリソースと同じリージョンにインスタンスを配置します。ほとんどの場合、ゾーンを指定する必要はありません。

[構成オプション] で、インスタンスに必要なその他の設定を更新します。

設定	注
データベースのバージョン
データベースのバージョン	MySQL 5.7（デフォルト）または 5.6。
接続
プライベート IP	インスタンスのプライベート IP 接続を構成します。詳細
パブリック IP	インスタンスのパブリック IPv4 アドレスを追加します。詳細
マシンタイプとストレージ
マシンタイプ	マシンタイプ（「層」とも呼ばれる）によって、CPU の数とインスタンスのメモリ量が決まります。詳細
ストレージの種類	インスタンスで SSD または HDD のどちらのストレージを使用するかを指定します。詳細
ストレージ容量	インスタンスにプロビジョニングされているストレージ容量。詳細
ストレージの自動増量	空き領域が少なくなったときに、Cloud SQL が自動的にインスタンス用のストレージを増やすかどうかを指定します。詳細
高可用性	高可用性向けにインスタンスを構成する必要がある場合は、[高可用性（リージョン）] チェックボックスをオンにする必要があります。詳細
自動バックアップ	バックアップを開始する時間枠。詳細
バイナリログ	バイナリログを使用すると、レプリケーションとポイントインタイムリカバリが可能になります。詳細
ネットワークの承認
データベースフラグの追加
データベースフラグ	データベースフラグを使用して、インスタンスの設定とパラメータを制御できます。詳細
メンテナンススケジュール
メンテナンスの時間枠	Cloud SQL がインスタンスに対し、中断メンテナンスを実行できる 1 時間の時間枠を指定します。この時間枠を設定しない場合、任意の時間に中断メンテナンスが行われる可能性があります。詳細
メンテナンスのタイミング	希望するインスタンス更新のタイミング。同じプロジェクトの他のインスタンスとの相対的なタイミングです。詳細

[作成] をクリックします。

gcloud（第 2 世代）

gcloud コマンドラインツールのインストール方法と使用方法については、Cloud SDK のインストールをご覧ください。Cloud Shell の起動方法については、Cloud Shell のドキュメントをご覧ください。

使用できるマシンタイプのリストを表示します。
```
gcloud sql tiers list
```
「db-」で始まるタイプがあります。第 2 世代インスタンスを作成するには、このタイプのマシンを選択する必要があります。

各マシンタイプ、それぞれの機能、インスタンスの料金に対する影響については、料金ページをご覧ください。

インスタンスを作成します。

gcloud sql instances create [INSTANCE_NAME] --tier=[MACHINE_TYPE] --region=[REGION]

インスタンス名には機密情報や個人を特定できる情報を含めないでください。インスタンス名は外部から閲覧可能です。
インスタンス名にプロジェクト ID を含める必要はありません。この処理は必要に応じて自動的に行われます（ログファイルの場合など）。

MACHINE_TYPE は、前のステップで取得した値のうち、db- で始まるものです。

たとえば、次のコマンドは、ロンドンリージョンに、マシンタイプが db-n1-standard-2 で、instance1 という名前の第 2 世代インスタンスを作成します。

gcloud sql instances create instance1 --tier=db-n1-standard-2 --region=europe-west2

パラメータを追加して、他のインスタンス設定を指定できます。

設定	パラメータ	注
必須パラメータ
データベースのバージョン	`--database-version`	`MYSQL_5_7`（デフォルト）または `MYSQL_5_6`。
リージョン	`--region`	有効な値を参照してください。
接続
プライベート IP	`--network`	このインスタンスに使用する VPC ネットワーク名を指定します。このネットワークに対して、プライベートサービスアクセスがすでに構成されている必要があります。ベータ版のコマンド（`gcloud beta sql instances create`）でのみ使用できます。詳細
パブリック IP	`--authorized-networks`	パブリック IP 接続の場合は、承認済みネットワークからのみ、インスタンスに接続できます。詳細
マシンタイプとストレージ
マシンタイプ	`--tier`	マシンのタイプによって、CPU の数とインスタンスのメモリ量が決まります。有効な値を参照してください。詳細
ストレージの種類	`--storage-type`	インスタンスで SSD または HDD のどちらのストレージを使用するかを指定します。詳細
ストレージ容量	`--storage-size`	インスタンスにプロビジョニングされているストレージ容量（GB 単位）。詳細
ストレージの自動増量	`--storage-auto-increase`	空き領域が少なくなったときに、Cloud SQL が自動的にインスタンス用のストレージを増やすかどうかを指定します。詳細
ストレージの自動増量の上限	`--storage-auto-increase-limit`	Cloud SQL が自動的に増量できるストレージ容量の上限を指定します。ベータ版のコマンド（`gcloud beta sql instances create`）でのみ使用できます。詳細
自動バックアップと高可用性
高可用性	`--failover-replica-name`	このパラメータを指定すると、新しいインスタンスのフェイルオーバーレプリカが作成されます。詳細
自動バックアップ	`--backup-start-time`	バックアップを開始する時間枠。詳細
バイナリログ	`--enable-bin-log`	バイナリログを使用すると、レプリケーションとポイントインタイムリカバリが可能になります。詳細
データベースフラグの追加
データベースフラグ	`--database-flags`	データベースフラグを使用して、インスタンスの設定とパラメータを制御できます。データベースフラグの詳細。このパラメータの設定方法の詳細。
メンテナンススケジュール
メンテナンスの時間枠	`--maintenance-window-day`, `--maintenance-window-hour`	Cloud SQL がインスタンスに対し、中断メンテナンスを実行できる 1 時間の時間枠を指定します。この時間枠を設定しない場合、任意の時間に中断メンテナンスが行われる可能性があります。詳細
メンテナンスのタイミング	`--maintenance-release-channel`	希望するインスタンス更新のタイミング。同じプロジェクトの他のインスタンスとの相対的なタイミングです。他のインスタンスより前に更新する場合は `preview` を使用し、後に更新する場合は `production` を使用します。詳細

自動的に割り当てられた IP アドレスをメモします。
Cloud SQL Proxy を使用していない場合、アプリケーションまたはツールがインスタンスに接続するためのホストアドレスとしてこのアドレスが使用されます。

「root@%」MySQL ユーザーのパスワードを設定します。

gcloud sql users set-password root % --instance [INSTANCE_NAME] --password [PASSWORD]

REST（第 2 世代）

1. インスタンスを作成する

この例では、バックアップおよびバイナリログを有効にしたインスタンスを作成します。これらの設定は任意です。この呼び出しのパラメータの一覧については、Instances:insert ページをご覧ください。リージョンやマシンタイプの有効な値など、インスタンスの設定の詳細については、インスタンスの設定をご覧ください。

インスタンス ID には機密情報や個人を特定できる情報を含めないでください。インスタンス ID は外部から閲覧可能です。
インスタンス名にプロジェクト ID を含める必要はありません。この処理は必要に応じて自動的に行われます（ログファイルの場合など）。

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

project-id: プロジェクト ID
instance-id: 目的のインスタンス ID
region: 目的のリージョン
machine-type: 目的のマシンタイプ

HTTP メソッドと URL:

POST https://www.googleapis.com/sql/v1beta4/projects/project-id/instances

JSON 本文のリクエスト

{
  "name": "instance-id",
  "region": "region",
  "settings": {
    "tier": "machine-type",
    "backupConfiguration": {
      "binaryLogEnabled": true,
      "enabled": true
    }
  }
}

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

curl（Linux、macOS、または Cloud Shell）

注: 下のコマンドでは、ご利用のユーザーアカウントで gcloud を認証する際に gcloud init または gcloud auth login を使用していることを前提としています。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://www.googleapis.com/sql/v1beta4/projects/project-id/instances

PowerShell（Windows）

リクエスト本文を 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://www.googleapis.com/sql/v1beta4/projects/project-id/instances" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2019-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

レスポンスは長時間実行オペレーションのため、完了まで数分かかる場合があります。

2. root のパスワードを更新する

インスタンスの初期化が完了したら、root のパスワードを更新します。

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

project-id: プロジェクト ID
instance-id: 前のステップで作成したインスタンス ID
root-password: 目的の root のパスワード

HTTP メソッドと URL:

PUT https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=%25&name=root

JSON 本文のリクエスト

{
  "name": "root",
  "host": "%",
  "password": "root-password"
}

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

curl（Linux、macOS、または Cloud Shell）

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

curl -X PUT \
-H "Authorization: Bearer "$(gcloud auth print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=%25&name=root

PowerShell（Windows）

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method PUT `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=%25&name=root" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "DONE",
  "user": "user@example.com",
  "insertTime": "2019-09-26T14:32:30.592Z",
  "startTime": "2019-09-26T14:32:30.594Z",
  "endTime": "2019-09-26T14:32:33.518Z",
  "operationType": "UPDATE_USER",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

レスポンスは長時間実行オペレーションのため、完了まで数分かかる場合があります。

3. IPv4 アドレスを取得する

新しいインスタンスに自動的に割り当てられる IPv4 アドレスを取得します。

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

project-id: プロジェクト ID
instance-id: 前のステップで作成したインスタンス ID

HTTP メソッドと URL:

GET https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

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

curl（Linux、macOS、または Cloud Shell）

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

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

PowerShell（Windows）

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

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

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_5_7",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-f1-micro",
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "ipv4Enabled": true
    },
    "locationPreference": {
      "zone": "us-west1-a",
      "kind": "sql#locationPreference"
    },
    "dataDiskType": "PD_SSD",
    "backupConfiguration": {
      "startTime": "18:00",
      "kind": "sql#backupConfiguration",
      "enabled": true,
      "binaryLogEnabled": true
    },
    "settingsVersion": "1",
    "storageAutoResizeLimit": "0",
    "storageAutoResize": true,
    "dataDiskSizeGb": "10"
  },
  "etag": "--redacted--",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "10.0.0.1"
    }
  ],
  "serverCaCert": {
    ...
  },
  "instanceType": "CLOUD_SQL_INSTANCE",
  "project": "project-id",
  "serviceAccountEmailAddress": "redacted@gcp-sa-cloud-sql.iam.gserviceaccount.com",
  "backendType": "SECOND_GEN",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "connectionName": "project-id:region:instance-id",
  "name": "instance-id",
  "region": "us-west1",
  "gceZone": "us-west1-a"
}

レスポンスで ipAddress フィールドを探します。

第 1 世代のインスタンスを作成する

第 1 世代インスタンスを作成するには:

Console（第 1 世代）

Google Cloud Console の Cloud SQL インスタンスページに移動します。
[Cloud SQL インスタンス] ページに移動
[インスタンスを作成] をクリックします。
[第 1 世代の MySQL インスタンスについては、ここをクリックしてください] リンクをクリックします。
名前を入力します。
インスタンス名には機密情報や個人を特定できる情報を含めないでください。インスタンス名は外部から閲覧可能です。
インスタンス名にプロジェクト ID を含める必要はありません。この処理は必要に応じて自動的に行われます（ログファイルの場合など）。
インスタンスの階層を選択します。
階層、その機能、料金に対する影響については、料金ページをご覧ください。
必要に応じて、省略可能なインスタンス設定を設定します。
省略可能な設定については、インスタンスの設定をご覧ください。
[作成] をクリックします。
インスタンスの初期化が終了した後、インスタンスを選択して開きます。
[ユーザー] タブを選択します。
[ユーザーアカウントを作成] をクリックして、root という名前のユーザーを作成し、パスワードを指定します。
MySQL ユーザー 'root'@'%' が作成されます。MySQL ユーザーについて詳しくは、MySQL ユーザーをご覧ください。

gcloud（第 1 世代）

使用できるマシンタイプのリストを表示します。
```
gcloud sql tiers list
```
大文字の「D」で始まるタイプがあります。第 1 世代インスタンスを作成するには、このタイプのマシンを選択する必要があります。他の値（db-n1-standard-1 など）を選択すると、第 2 世代インスタンスが作成されます。

各階層、それぞれの機能、インスタンスの料金に対する影響については、料金ページをご覧ください。
インスタンスを作成します。
```
gcloud sql instances create [INSTANCE_NAME] --tier=[TIER]
```
インスタンス名には機密情報や個人を特定できる情報を含めないでください。インスタンス名は外部から閲覧可能です。
インスタンス名にプロジェクト ID を含める必要はありません。この処理は必要に応じて自動的に行われます（ログファイルの場合など）。

TIER は、gcloud sql tiers list コマンドで出力される値のうち、大文字の D で始まるものです。
たとえば、次のコマンドは、instance1 という名前でマシンタイプが D4 の第 1 世代インスタンスを作成します。
```
gcloud sql instances create instance1 --tier=D4
```
使用できる他のパラメータについては、gcloud sql instances create コマンドのリファレンスと、インスタンスの設定をご覧ください。
インスタンスの「root@%」ユーザーアカウントを有効にします。
```
gcloud sql users set-password root % --instance [INSTANCE_NAME] --password [PASSWORD]
```
MySQL プロトコルを使用してインスタンスに接続するには、先にこの MySQL ユーザーアカウントを有効にする必要があります。
自動的に割り当てられる IPv6 アドレスを取得します。
```
gcloud sql instances describe [INSTANCE_NAME]
```
出力で、ipv6Address フィールドを探します。アプリケーションやツールがインスタンスに接続するときの IP アドレスとしてこれを使用できます。 IPv4 アドレスをリクエストすることもできますが、インスタンスが有効になっていない間でも若干の料金がかかります。

cURL（第 1 世代）

インスタンスを作成します。
```
gcloud auth login
ACCESS_TOKEN="$(gcloud auth print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{"name":"[INSTANCE_NAME]", "region":"[REGION]",
              "settings": {"tier":"[TIER]",
              "backupConfiguration": {"binaryLogEnabled":true, "enabled":true}}}' \
     -X POST \
     https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances
```
インスタンス名には機密情報や個人を特定できる情報を含めないでください。インスタンス名は外部から閲覧可能です。
インスタンス名にプロジェクト ID を含める必要はありません。この処理は必要に応じて自動的に行われます（ログファイルの場合など）。

この例では、バックアップとバイナリログが有効で、アクティベーションポリシーが ON_DEMAND であるインスタンスを作成します。

この呼び出しのパラメータの完全なリストについては、Instances:insert ページをご覧ください。リージョンや階層の有効な値など、インスタンスの設定の詳細については、インスタンスの設定をご覧ください。

インスタンスの初期化が終了した後、root ユーザーアカウントを有効にします。

curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{"name": "root", "host": "%", "password": "[ROOT_PASSWORD]"}' \
     -X PUT \
     'https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[INSTANCE_NAME]/users?host=%25&name=root'

新しいインスタンスに自動的に割り当てられる IPv6 アドレスを取得します。
```
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     -X GET \
     https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[INSTANCE_NAME]
```
レスポンスで ipv6Address フィールドを探します。

インスタンスを作成する

第 2 世代のインスタンスを作成する

Console（第 2 世代）

gcloud（第 2 世代）

REST（第 2 世代）

1. インスタンスを作成する

curl（Linux、macOS、または Cloud Shell）

PowerShell（Windows）

2. root のパスワードを更新する

curl（Linux、macOS、または Cloud Shell）

PowerShell（Windows）

3. IPv4 アドレスを取得する

curl（Linux、macOS、または Cloud Shell）

PowerShell（Windows）

第 1 世代のインスタンスを作成する

Console（第 1 世代）

gcloud（第 1 世代）

cURL（第 1 世代）

次のステップ