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

gcloud

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

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

   gcloud sql instances describe INSTANCE_NAME
   

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

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sql_network_architecture: OLD_NETWORK_ARCHITECTURE
  

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

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sql_network_architecture: NEW_NETWORK_ARCHITECTURE
  

sql_network_architecture パラメータにより、インスタンスが以前のネットワーク アーキテクチャ（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 -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"

$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 -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"

$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)
  ...
}

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 -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"

$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 -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"

$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)
  ...
}

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 -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"

$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 を使用します。

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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

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

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$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/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
  ...
}

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