クラスタの削除

このページでは、Game Servers クラスタを削除する方法について説明します。

始める前に

始める前に、Game Servers の概要の主なコンセプトを理解しておくことをおすすめします。次のタスクも完了していることを確認してください。

  • Game Services API が有効になっていることを確認します。
    • Game Services API を有効にする
  • gcloud CLI がインストールされているシェルを選択するか、API クライアントを使用します。

    • Cloud Shell

    Cloud Shell を起動するには、次の手順に従います。

    1. Google Cloud Console に移動します。

      Google Cloud Console

    2. コンソールの右上隅にある [Cloud Shell をアクティブにする] ボタン をクリックします。

    コンソールの下部にあるフレーム内で Cloud Shell セッションが開きます。このシェルで gcloud コマンドを実行します。

    ローカルシェル

    gcloud CLI をインストールします。

    Google Cloud CLI に必要なデフォルトのプロジェクトが設定されていることを確認します（設定されていない場合、後でコマンドごとに --project フラグを明示的に指定する必要があります）。

    gcloud config list project

    デフォルト プロジェクトを設定していない場合は、次のコマンドを実行して、デフォルト プロジェクトを設定します。PROJECT_ID は、設定するプロジェクト ID に置き換えてください。

    gcloud config set project PROJECT_ID

    次のコマンドを実行して、Google Cloud CLI のバージョンを確認します。Game Servers には、gcloud CLI のバージョン 306.0.0 以降が必要です。 

    gcloud version

    インストールを更新するには、次のコマンドを実行します。

    gcloud components update

    curl / PowerShell

    REST API を curl または Windows PowerShell で使用するには、次の操作を行います。

    1. サービス アカウントを作成する。
    2. 秘密鍵を JSON ファイルとしてダウンロードします。

    3. 環境変数 GOOGLE_APPLICATION_CREDENTIALS を、認証情報を含む JSON ファイルのパスに設定します。この変数は現在のシェル セッションにのみ適用されるため、新しいセッションを開く場合は、変数を再度設定する必要があります。

    クライアント ライブラリ

    Google Cloud Game Servers は、クライアント ライブラリを使用して、プログラムで制御できます。ライブラリと認証の手順については、クライアント ライブラリの概要をご覧ください。

クラスタの削除

Game Servers クラスタを削除しても、クラスタ内のリソースは削除されません。

Console

  1. Google Cloud コンソールで、[レルムとクラスタ] ページに移動します。

    Game Servers に移動

  2. レルムを展開して、レルムに所属するゲームサーバー クラスタを確認します。

  3. クラスタの最後のテーブル列で、省略記号 をクリックし、[ゲームサーバー クラスタを削除] を選択します。

gcloud

Google Cloud CLI を使用して、Game Servers のグローバル クラスタまたはリージョン クラスタを削除できます。

グローバル クラスタを削除するには:

  1. 次のコマンドを実行します。clusterID や realmID などのプレースホルダ値は、適切な値に置き換えます。

    gcloud game servers clusters delete clusterID --realm=realmID --dry-run

    クラスタを削除する前にオペレーションをプレビューできるように、出力では targetState が返されます。

  2. クラスタを削除するには、次のコマンドを実行します。

    gcloud game servers clusters delete clusterID --realm=realmID --no-dry-run

リージョン クラスタを削除するには:

  1. 次のコマンドを実行します。clusterID などのプレースホルダの値は、適切な値に置き換えます。

    gcloud game servers clusters delete clusterID --realm=realmID --location=region --dry-run

    クラスタを削除する前にオペレーションをプレビューできるように、出力では targetState が返されます。

  2. クラスタを削除するには、次のコマンドを実行します。

    gcloud game servers clusters delete clusterID --realm=realmID --location=region --no-dry-run

変数のプレースホルダは、次の説明のとおりです。

  • clusterID は、このクラスタに指定した一意の ID です。
  • realmID は、このクラスタの親レルムに指定した一意の ID です。
  • region は、クラスタのリージョンです（該当する場合）。親のレルムと同じ場所を選択します。

REST

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

  • PROJECT_ID: IAM 設定に載っている Google Cloud プロジェクト ID。
  • REALM_LOCATION: レルムのリージョンまたは global。
  • REALM_ID: レルムのユーザー定義の識別子。
  • GS_CLUSTER_ID: クラスタのユーザー定義の識別子。

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

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

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID/gameServerClusters/GS_CLUSTER_ID",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

クラスタが削除されたことを確認する

Google Cloud CLI を使用してグローバル クラスタまたはリージョン クラスタを一覧表示し、クラスタが正常に削除されたことを確認します。

すべてのクラスタを一覧表示するには、次のコマンドを実行します。

gcloud game servers clusters list

リージョン内のクラスタを一覧表示するには、次のコマンドを実行します。region は、クラスタを一覧表示するリージョンに置き換えます。

gcloud game servers clusters list --location=region

レルム内のすべてのクラスタを一覧表示するには、次のコマンドを実行します。realmID は親レルムに、region はクラスタのリージョンに置き換えます（該当する場合）。

gcloud game servers clusters list --realm=realmID --location=region

削除したクラスタは、コマンドの出力に表示されなくなります。

次のステップ

Game Servers の概要の主なコンセプトについて学習する。