インスタンスを新しいネットワークアーキテクチャにアップグレードする

MySQL | PostgreSQL | SQL Server

このページでは、Cloud SQL インスタンスを古いネットワークアーキテクチャから新しいネットワークアーキテクチャにアップグレードする方法について説明します。

この Cloud SQL ネットワークアーキテクチャのアップグレードページは、特定の Cloud SQL インスタンスにのみ適用されます。Cloud SQL インスタンスが、2021 年 8 月より前に作成された Virtual Private Cloud（VPC）ネットワークプロジェクトを使用している場合は、インスタンスの Cloud SQL ネットワークアーキテクチャをアップグレードする必要があります。

概要

次の表に、以前のネットワークアーキテクチャと比較した新しいネットワークアーキテクチャの利点を示します。

機能	以前のネットワークアーキテクチャ	新しいネットワークアーキテクチャ
Database Migration Service を使用した Cloud SQL から AlloyDB for PostgreSQL への移行、および AlloyDB for PostgreSQL から Cloud SQL への移行	移行用にプライベート IP アドレスを構成する必要があります。	追加のネットワーク構成は不要です。たとえば、Cloud SQL から AlloyDB for PostgreSQL への移行、AlloyDB for PostgreSQL から Cloud SQL への移行などが該当します。
プライベート IP を使用して、Cloud SQL インスタンスを Cloud Build や Vertex AI などの限定公開サービスに接続する	ネットワークピアリングの非推移性のため、サポート対象外	サポート対象
Assured Workloads に準拠したインスタンス	サポート対象外	サポート対象
Managed Microsoft AD	サポート対象外	サポート対象
Private Service Connect	サポート対象外	サポート対象
プロジェクトあたりのデフォルトの Cloud SQL インスタンスの割り当て	100	1,000

アップグレードを計画する

Cloud SQL インスタンスのネットワークアーキテクチャをアップグレードする前に、次のアップグレードの制約に合わせてアップグレードを計画します。

ネットワークアーキテクチャをアップグレードすると、インスタンスのダウンタイムは平均で最大 4 分間発生する可能性があります。
データの移行が進行中の場合、その間は、ソースインスタンスを新しいアーキテクチャにアップグレードできません。
外部ソースからインスタンスに接続する場合は、すべてのピアリング接続が更新され、カスタムルートのエクスポートが有効になっていることを確認します。
Cloud SQL インスタンスの数が 300 個を超えるネットワークでは、インスタンスのネットワークアーキテクチャをアップグレードすることはできません。
ネットワークの同じリージョン内に、プライベート IP アドレスを使用するインスタンスが 2 つ以上含まれている場合、Cloud SQL は、割り振られた限定公開サービスアクセスの IP アドレス範囲から追加の /24 範囲を使用して、新しいネットワークアーキテクチャのインスタンスをホストする必要があります。この追加の使用は一時的なもので、その後の Cloud SQL メンテナンスイベントで削除されます。

フェイルオーバーレプリカを使用した以前の高可用性（HA）インスタンスはアップグレードでサポートされていません。
ネットワークアーキテクチャをアップグレードすると、アップグレードされたインスタンスの以前の HA フェイルオーバーレプリカを作成できなくなります。

ネットワークプロジェクト内の Cloud SQL インスタンスすべてのアップグレードを計画する

Cloud SQL インスタンスは、VPC ネットワークと同じプロジェクトに配置することも、別のプロジェクトでホストすることもできます。VPC ネットワークをホストするプロジェクトは、ネットワークプロジェクトです。

ネットワークプロジェクト内で Cloud SQL インスタンスが一つでも以前のネットワークアーキテクチャを使用していれば、プロジェクト全体で以前のネットワークアーキテクチャが使用されます。この場合、プロジェクトは、新しいネットワークアーキテクチャに完全にはアップグレードされません。

プロジェクト内のすべての Cloud SQL インスタンスのネットワークアーキテクチャは、gcloud CLI または Cloud SQL Admin API を使用して確認できます。

インスタンスのプライベートネットワークを変更する場合や、インスタンスのプライベート IP を有効にする場合、同じリクエストでネットワークアーキテクチャを変更することはできません。そのようなリクエストは拒否されます。これを回避するため、ネットワークプロジェクトを変更する前に、ネットワークプロジェクトのすべてのインスタンスをアップグレードすることをおすすめします。

Cloud SQL のネットワークアーキテクチャをアップグレードする

Cloud SQL インスタンスのネットワークアーキテクチャをアップグレードする手順は次のとおりです。

1 つの Cloud SQL インスタンスまたは複数の Cloud SQL インスタンスのネットワークアーキテクチャを確認します。
Cloud SQL インスタンスのネットワークアーキテクチャをアップグレードします。

1 つの Cloud SQL インスタンスのネットワークアーキテクチャを確認する

1 つのインスタンスの現在のネットワークアーキテクチャを確認するには、gcloud sql instances describe コマンドまたは instances.get メソッドを使用します。

gcloud

gcloud CLI のインストールと使用開始については、gcloud CLI をインストールするをご覧ください。Cloud Shell の起動については、Cloud Shell を使用するをご覧ください。

1 つのインスタンスのネットワークアーキテクチャを確認するには、次のコマンドを実行します。

   gcloud sql instances describe INSTANCE_NAME

インスタンスが以前のネットワークアーキテクチャを使用している場合、レスポンスは次のようになります。

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sqlNetworkArchitecture: OLD_NETWORK_ARCHITECTURE

インスタンスが新しいネットワークアーキテクチャを使用している場合、レスポンスは次のようになります。

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sqlNetworkArchitecture: NEW_NETWORK_ARCHITECTURE

sqlNetworkArchitecture パラメータにより、インスタンスが以前のネットワークアーキテクチャ（OLD_NETWORK_ARCHITECTURE）を使用しているのか、それとも新しいネットワークアーキテクチャ（NEW_NETWORK_ARCHITECTURE）を使用しているのかが示されます。

REST v1

インスタンスのネットワークアーキテクチャを確認するには、Cloud SQL Admin API の instances.get メソッドを使用します。

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

PROJECT_ID: プロジェクト ID。
INSTANCE_NAME: インスタンス名。
NETWORK_ARCHITECTURE_TYPE: ネットワークアーキテクチャタイプは次のように定義されます。
- OLD_NETWORK_ARCHITECTURE: インスタンスは以前のネットワークアーキテクチャを使用します。
- NEW_NETWORK_ARCHITECTURE: インスタンスは新しいネットワークアーキテクチャを使用します。

HTTP メソッドと URL:

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

curl（Linux、macOS、Cloud Shell）

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

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

curl -X GET \
     -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 GET `
    -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#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

REST v1beta4

インスタンスのネットワークアーキテクチャを確認するには、Cloud SQL Admin API の instances.get メソッドを使用します。

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

PROJECT_ID: プロジェクト ID。
INSTANCE_NAME: インスタンス名。
NETWORK_ARCHITECTURE_TYPE: ネットワークアーキテクチャタイプは次のように定義されます。
- OLD_NETWORK_ARCHITECTURE: インスタンスは以前のネットワークアーキテクチャを使用します。
- NEW_NETWORK_ARCHITECTURE: インスタンスは新しいネットワークアーキテクチャを使用します。

HTTP メソッドと URL:

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

curl（Linux、macOS、Cloud Shell）

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

curl -X GET \
     -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/INSTANCE_NAME"

PowerShell（Windows）

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

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

複数の Cloud SQL インスタンスのネットワークアーキテクチャを確認する

1 つのプロジェクトに存在する複数のインスタンスのネットワークアーキテクチャを確認するには、gcloud sql instances list コマンドまたは instance.list メソッドを使用します。

gcloud

1 つのプロジェクトに存在する複数のインスタンスのネットワークアーキテクチャを確認するには、次のコマンドを実行します。

gcloud sql instances list --show-sql-network-architecture

出力は次のようになります。

NAME        DATABASE_VERSION LOCATION   ...     SQL_NETWORK_ARCHITECTURE
instance_1  POSTGRES_13      asia-northeast1-b  OLD_NETWORK_ARCHITECTURE
instance_2  MYSQL_5_7        europe-west1-d     NEW_NETWORK_ARCHITECTURE
...

REST v1

1 つのプロジェクトに存在する複数のインスタンスのネットワークアーキテクチャを確認するには、instance.list メソッドを使用します。

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

PROJECT_ID: プロジェクト ID。
NETWORK_ARCHITECTURE_TYPE: 次のネットワークアーキテクチャタイプ。
- OLD_NETWORK_ARCHITECTURE: インスタンスは以前のネットワークアーキテクチャを使用します。
- NEW_NETWORK_ARCHITECTURE: インスタンスは新しいネットワークアーキテクチャを使用します。

HTTP メソッドと URL:

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

curl（Linux、macOS、Cloud Shell）

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

curl -X LIST \
     -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）

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

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

Invoke-WebRequest `
    -Method LIST `
    -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#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

REST v1beta4

1 つのプロジェクトに存在する複数のインスタンスのネットワークアーキテクチャを確認するには、instance.list メソッドを使用します。

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

PROJECT_ID: プロジェクト ID。
NETWORK_ARCHITECTURE_TYPE: ネットワークアーキテクチャタイプは次のように定義されます。
- OLD_NETWORK_ARCHITECTURE: インスタンスは以前のネットワークアーキテクチャを使用します。
- NEW_NETWORK_ARCHITECTURE: インスタンスは新しいネットワークアーキテクチャを使用します。

HTTP メソッドと URL:

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

curl（Linux、macOS、Cloud Shell）

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

curl -X LIST \
     -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）

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

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

Invoke-WebRequest `
    -Method LIST `
    -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#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

1 つの Cloud SQL インスタンスのネットワークアーキテクチャをアップグレードする

1 つのインスタンスのネットワークアーキテクチャをアップグレードするには、gcloud sql instances patch コマンド、instance.update メソッド、または instance.patch メソッドを使用します。

gcloud

インスタンスのネットワークアーキテクチャをアップグレードするには、次のコマンドを実行します。

gcloud sql instances patch INSTANCE_NAME --upgrade-sql-network-architecture

アップグレードには数分かかります。

アップグレードの際には、長時間実行オペレーションが開始され、オペレーショントークンが返されます。

operation_id

REST v1

インスタンスのネットワークアーキテクチャをアップグレードするには、Cloud SQL Admin API の instance.update または instance.patch メソッドを使用します。

Cloud SQL ネットワークアーキテクチャをアップグレードする場合、インスタンスに対する別の更新をリクエストに含めることはできません。リクエストの本文には、sqlNetworkArchitecture を NEW_NETWORK_ARCHITECTURE に設定した DatabaseInstance オブジェクトのインスタンスを含めます。

アップグレードの際には、長時間実行オペレーションが開始され、オペレーショントークンが返されます。

operation_id

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

PROJECT_ID: プロジェクト ID。
INSTANCE_NAME: インスタンス名。
NETWORK_ARCHITECTURE_TYPE: ネットワークアーキテクチャタイプは次のように定義されます。
- OLD_NETWORK_ARCHITECTURE: インスタンスは以前のネットワークアーキテクチャを使用します。
- NEW_NETWORK_ARCHITECTURE: インスタンスは新しいネットワークアーキテクチャを使用します。

HTTP メソッドと URL:

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

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）

リクエスト本文を 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#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

インスタンスのアップグレードが失敗した場合は、アップグレードオペレーションを再試行してください。

REST v1beta4

インスタンスのネットワークアーキテクチャをアップグレードするには、Cloud SQL Admin API の instance.update method または instance.patch method を使用します。

アップグレードの際には、長時間実行オペレーションが開始され、次のオペレーショントークンが返されます。

operation_id

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

PROJECT_ID: プロジェクト ID。
INSTANCE_NAME: インスタンス名。
NETWORK_ARCHITECTURE_TYPE: ネットワークアーキテクチャタイプは次のように定義されます。
- OLD_NETWORK_ARCHITECTURE: インスタンスは以前のネットワークアーキテクチャを使用します。
- NEW_NETWORK_ARCHITECTURE: インスタンスは新しいネットワークアーキテクチャを使用します。

HTTP メソッドと URL:

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

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

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）

リクエスト本文を 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#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

なんらかの理由でインスタンスのアップグレードが失敗した場合は、アップグレードオペレーションを再試行できます。

よくある質問

このセクションでは、Cloud SQL ネットワークアーキテクチャのアップグレードに関するよくある質問に対する回答を記載します。

アップグレードは Cloud SQL インスタンスにどのような影響を与えますか？
アップグレード後、すべての機能は同じように動作しますか？
どのインスタンスが以前のネットワークアーキテクチャを使用していますか？
新しい Cloud SQL インスタンスはすべて新しいネットワークアーキテクチャ上に作成されますか？
1 つのコマンドでプロジェクトに含まれるすべてのインスタンスを更新できますか？
プライマリをアップグレードすると、レプリカも自動的にアップグレードされますか？
Cloud SQL インスタンスのネットワークアーキテクチャがアップグレードされるという通知を受け取りました。どうすればよいですか？
ゾーンインスタンスのネットワークアーキテクチャをアップグレードできないのはなぜですか？
インスタンスをアップグレードしようとすると、「予約済み IP アドレス範囲外」というエラーが表示されます。どうすればよいですか？

アップグレードは Cloud SQL インスタンスにどのような影響を与えますか？

ネットワークアーキテクチャをアップグレードすると、Cloud SQL インスタンスは MAINTENANCE 状態になります。この状態のインスタンスでは、平均で最大 4 分間のダウンタイムが発生します。アップグレードが完了するまで、インスタンスに対する追加の変更は許可されません。プロジェクトまたはネットワーク内の他のインスタンスはアップグレードの影響を受けません。

アップグレード後、すべての機能は同じように動作しますか？

新しいアーキテクチャでは、Cloud SQL インスタンスのすべての機能が古いアーキテクチャと同じように動作します。新しいネットワークアーキテクチャを使用するようにインスタンスをアップグレードした後、そのインスタンスのネットワークを切り替える場合は、宛先ネットワーク内のすべてのインスタンスも新しいネットワークアーキテクチャにアップグレードされていることを確認してください。

どのインスタンスが以前のネットワークアーキテクチャを使用していますか？

2021 年 8 月以降に作成された新しいプロジェクトでは、新しいネットワークアーキテクチャが自動的に使用されます。既存のプロジェクトでは、2 年以上経過した Cloud SQL インスタンスで以前のネットワークアーキテクチャを使用している場合があります。したがって、そのプロジェクトの新しいインスタンスで新しいネットワークアーキテクチャを使い始めるには、そのプロジェクト内のすべてのインスタンスをアップグレードする必要があります。

新しい Cloud SQL インスタンスはすべて新しいネットワークアーキテクチャ上に作成されますか？

デフォルトでは、2021 年 8 月以降に作成されたプロジェクトで作成された新しい Cloud SQL インスタンスは、新しいネットワークアーキテクチャを使用します。

2021 年 8 月より前に作成されたプロジェクトでインスタンスを作成して新しいネットワークアーキテクチャを使用する場合は、そのプロジェクト内の既存のインスタンスをすべて新しいネットワークアーキテクチャに更新する必要があります。共有 VPC を使用している場合は、共有 VPC に参加しているプロジェクト内のすべてのインスタンスを更新する必要があります。

プロジェクト内の既存のインスタンスをすべて更新したら、数時間待ってからプロジェクトにインスタンスを作成します。プロジェクトで作成する新しいインスタンスは、新しいネットワークアーキテクチャを使用します。

1 つのコマンドでプロジェクトに含まれるすべてのインスタンスを更新できますか？

いいえ。新しいネットワークアーキテクチャへのアップグレードは、各インスタンスに基づいて行われます。

プライマリをアップグレードすると、レプリカも自動的にアップグレードされますか？

いいえ。新しいネットワークアーキテクチャへのアップグレードは、個々のインスタンスに基づいて行われます。各レプリカは個別のインスタンスとして扱われ、個別にアップグレードする必要があります。つまり、プライマリがアップグレードされ、レプリカが以前のネットワークアーキテクチャを使用している場合、レプリカは影響を受けません。その逆も同様です。レプリカをアップグレードしても、プライマリは影響を受けません。

Cloud SQL インスタンスのネットワークアーキテクチャがアップグレードされるという通知を受け取りました。どうすればよいですか？

お客様による対応は必要ありません。

インスタンスによっては、プライベートネットワークで自動アップグレードが実行されるときに、リクエストが一時的に拒否されるものがあります。回避策として、1 つの Cloud SQL インスタンスのネットワークアーキテクチャをアップグレードするの手順に沿って、インスタンスのネットワークアーキテクチャを自分でアップグレードしてください。

ゾーンインスタンスのネットワークアーキテクチャをアップグレードできないのはなぜですか？

インスタンス構成でゾーンの可用性が有効になっており、最後の定期メンテナンスイベントがスキップされている場合は、新しいネットワークアーキテクチャへのアップグレードがインスタンスでサポートされていない可能性があります。この問題を回避するには、インスタンスで高可用性を有効にして、ネットワークアーキテクチャをアップグレードします。アップグレードが完了したら、インスタンス構成をゾーンの可用性に戻してください。

インスタンスをアップグレードしようとすると、「予約済み IP アドレス範囲外」というエラーが表示されます。どうすればよいですか？

プライベート IP を使用する VPC ネットワークで Cloud SQL インスタンスを使用するには、VPC ネットワークの限定公開サービスアクセスを設定するときに IP アドレス範囲を割り振ります。

たとえば、IP アドレス範囲の割り振りが変更または削除されると、次のようなエラーが発生することがあります。

Network architecture upgrade not allowed for private-ip instance PROJECT_ID:INSTANCE_NAME
whose IP address range 10.0.0.0/24 is outside the reserved IP address range for
private services access. Re-allocate the IP address range for private services access and retry.

この例では、最初に割り振られた IP アドレス範囲の名前は google-managed-services-VPC_NETWORK_NAME で、最初に割り振られた IP アドレス範囲は 10.0.0.0/16 です。次に、プライベート IP アドレスが 10.0.0.1 のインスタンスを作成します。google-managed-services-VPC_NETWORK_NAME の IP アドレス範囲が削除された場合や、10.1.0.0/16 の範囲を参照するように更新された場合、この範囲はインスタンスのプライベート IP アドレス 10.0.0.1 をカバーしません。その後、インスタンスのネットワークアーキテクチャをアップグレードしようとすると、outside the reserved IP address range エラーが発生します。

この問題を解決するには、Cloud SQL 用に限定公開サービスアクセスを構成するの手順に沿って操作します。インスタンスの IP アドレスを含む IP アドレス範囲を、限定公開サービスアクセス用に割り振られた範囲に再割り振りします。少なくとも、エラーメッセージで報告された IP アドレス範囲を割り振ることができます（前述の例では 10.0.0.0/24）。

次に、ネットワークアーキテクチャのアップグレードを再試行します。

次のステップ

Private Service Connect の詳細を確認する
Assured Workloads の詳細を確認する
Cloud SQL 用にプライベートサービスアクセスを構成するの詳細を確認する
AlloyDB for PostgreSQL へのデータベース移行サービスの詳細を確認する

インスタンスを新しいネットワーク アーキテクチャにアップグレードする

概要

アップグレードを計画する

ネットワーク プロジェクト内の Cloud SQL インスタンスすべてのアップグレードを計画する

Cloud SQL のネットワーク アーキテクチャをアップグレードする

1 つの Cloud SQL インスタンスのネットワーク アーキテクチャを確認する

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

複数の Cloud SQL インスタンスのネットワーク アーキテクチャを確認する

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

1 つの Cloud SQL インスタンスのネットワーク アーキテクチャをアップグレードする

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

よくある質問

アップグレードは Cloud SQL インスタンスにどのような影響を与えますか？

アップグレード後、すべての機能は同じように動作しますか？

どのインスタンスが以前のネットワーク アーキテクチャを使用していますか？

新しい Cloud SQL インスタンスはすべて新しいネットワーク アーキテクチャ上に作成されますか？

1 つのコマンドでプロジェクトに含まれるすべてのインスタンスを更新できますか？

プライマリをアップグレードすると、レプリカも自動的にアップグレードされますか？

Cloud SQL インスタンスのネットワーク アーキテクチャがアップグレードされるという通知を受け取りました。どうすればよいですか？

ゾーン インスタンスのネットワーク アーキテクチャをアップグレードできないのはなぜですか？

インスタンスをアップグレードしようとすると、「予約済み IP アドレス範囲外」というエラーが表示されます。どうすればよいですか？

次のステップ

インスタンスを新しいネットワークアーキテクチャにアップグレードする

ネットワークプロジェクト内の Cloud SQL インスタンスすべてのアップグレードを計画する

Cloud SQL のネットワークアーキテクチャをアップグレードする

1 つの Cloud SQL インスタンスのネットワークアーキテクチャを確認する

複数の Cloud SQL インスタンスのネットワークアーキテクチャを確認する

1 つの Cloud SQL インスタンスのネットワークアーキテクチャをアップグレードする

どのインスタンスが以前のネットワークアーキテクチャを使用していますか？

新しい Cloud SQL インスタンスはすべて新しいネットワークアーキテクチャ上に作成されますか？

Cloud SQL インスタンスのネットワークアーキテクチャがアップグレードされるという通知を受け取りました。どうすればよいですか？

ゾーンインスタンスのネットワークアーキテクチャをアップグレードできないのはなぜですか？