インスタンスの起動、停止、再起動

MySQL   |  PostgreSQL   |  SQL Server

このページでは、インスタンスを起動または停止する方法と、実行中のインスタンスを再起動する方法について説明します。

アクティベーション ポリシー

インスタンスを起動、停止、再起動するときに、使用するアクティベーション ポリシーを設定する必要があります。アクティベーション ポリシーは、接続リクエストを受け入れるためにインスタンスがアクティブになっているかどうかを示します。

アクティベーション ポリシーのオプションは次のとおりです。

• ALWAYS - インスタンスは常に起動しています。
• NEVER - インスタンスは再起動されません。

MySQL インスタンスを使用している場合、通常、接続リクエストを受け入れるには有効化ポリシーを ALWAYS に設定してます。インスタンスを使用していない場合は、アクティベーション ポリシーを NEVER に設定してインスタンスの課金を避けることができます。

注: NEVER はリードレプリカ インスタンスではサポートされていません。

インスタンスの起動

停止されたインスタンスを起動するには:

コンソール

1. Google Cloud Console の Cloud SQL インスタンス ページに移動します。

   [Cloud SQL インスタンス] ページに移動

2. インスタンス名をクリックし、起動するインスタンスを選択します。
3. ページの上部にあるボタンバーの [起動] ボタンをクリックします。
4. [データベース インスタンスを起動しますか？] ダイアログ ボックスで、[起動] をクリックします。
   インスタンスのアクティベーション ポリシーが [常にオン] に設定され、インスタンスが起動します。

gcloud

アクティベーション ポリシーに対して [常にオン] を使用するには:

gcloud sql instances patch [INSTANCE_NAME] --activation-policy ALWAYS

REST

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

• project-id: プロジェクト ID
• instance-id: インスタンス ID
• activation-policy: アクティベーション ポリシーは [常にオン] または [常にオフ] です

HTTP メソッドと URL:

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

JSON 本文のリクエスト:

{
  "settings": {
    "activationPolicy": "activation-policy"
  }
}

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

curl（Linux、macOS、Cloud Shell）

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

PowerShell（Windows）

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

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

{
  "kind": "sql#operation",
  "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-20T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

基盤となる REST API リクエストがこのタスクでどのように作成されるかについては、インスタンス: patch ページの API Explorer をご覧ください。

インスタンスの停止

必要に応じてインスタンスを手動で停止できます。インスタンスを停止すると、再起動するまで停止されたままになり、アプリケーション接続に応答しません。

インスタンスを停止すると、インスタンスの料金が一時停止されます。インスタンス データは影響を受けず、ストレージと IP アドレスの料金は引き続き適用されます。

注: リードレプリカ インスタンスを stop することはできません。

インスタンスを停止するには:

コンソール

1. Google Cloud Console の Cloud SQL インスタンス ページに移動します。

   [Cloud SQL インスタンス] ページに移動

2. インスタンス名をクリックし、停止するインスタンスを選択します。
3. ページの上部にあるボタンバーの [停止] ボタンをクリックします。
4. [データベース インスタンスを停止しますか？] ダイアログ ボックスで、[停止] をクリックします。

   インスタンスのアクティベーション ポリシーが Off（常にオフ）に設定され、インスタンスが停止します。

gcloud

gcloud sql instances patch [INSTANCE_NAME] --activation-policy NEVER

REST

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

• project-id: プロジェクト ID
• instance-id: インスタンス ID
• activation-policy: 有効化ポリシーは [常にオフ] です

HTTP メソッドと URL:

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

JSON 本文のリクエスト:

{
  "settings": {
    "activationPolicy": "activation-policy"
  }
}

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

curl（Linux、macOS、Cloud Shell）

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

PowerShell（Windows）

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

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

{
  "kind": "sql#operation",
  "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-20T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

基盤となる REST API リクエストがこのタスクでどのように作成されるかについては、インスタンス: patch ページの API Explorer をご覧ください。

インスタンスの再起動

インスタンスを再起動すると、インスタンスから接続がドレインされ、インスタンスは停止します。次に、アクティベーション ポリシーが Always のインスタンスが再起動され、新しい接続を受け入れる準備が整います。アクティベーション ポリシーが On Demand のインスタンスは、そのインスタンスに対して新しい接続がリクエストされるまで停止したままになります。リクエストされた時点でインスタンスは有効になり、リクエストを受け入れます。

注: 実行中のインスタンスを再起動することで、インスタンスに関する問題が解決される場合があります。 ただし、インスタンスを再起動すると、サービスが中断され、インスタンス キャッシュが削除されます。そのため、一時的にパフォーマンスが低下します。インスタンスを再起動したばかりの場合は、インスタンス ログをチェックして、完全に復旧しているか確認してから、再起動するようにしてください。

インスタンスを再起動するには:

コンソール

1. Google Cloud Console の Cloud SQL インスタンス ページに移動します。

   [Cloud SQL インスタンス] ページに移動

2. インスタンス名をクリックして、再起動するインスタンスを選択します。
3. ページの上部にあるボタンバーの [再起動] ボタンをクリックします。
4. [データベース インスタンスを再起動しますか？] ダイアログ ボックスで、[再起動] をクリックします。

gcloud

インスタンスを再起動します。

gcloud sql instances restart [INSTANCE_NAME]

REST

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

• project-id: プロジェクト ID
• instance-id: インスタンス ID
• activation-policy: アクティベーション ポリシーは [常にオン] または [常にオフ] です

HTTP メソッドと URL:

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

JSON 本文のリクエスト:

{
  "settings": {
    "activationPolicy": "activation-policy"
  }
}

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

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/instance-id/restart

PowerShell（Windows）

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

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

{
  "kind": "sql#operation",
  "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-20T21:30:35.667Z",
  "operationType": "RESTART",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

このタスクで基盤となる REST API リクエストがどのように作成されるかについては、API Explorer の instances: restart ページをご覧ください。