このページでは、Game Servers クラスタを削除する方法について説明します。
始める前に
始める前に、Game Servers の概要の主なコンセプトを理解しておくことをおすすめします。次のタスクも完了していることを確認してください。
- Game Services API が有効になっていることを確認します。 Game Services API を有効にする
- gcloud CLI がインストールされているシェルを選択するか、API クライアントを使用します。
Google Cloud Console に移動します。
コンソールの右上隅にある [Cloud Shell をアクティブにする] ボタン
をクリックします。
- サービス アカウントを作成する。
- 秘密鍵を JSON ファイルとしてダウンロードします。
-
環境変数
GOOGLE_APPLICATION_CREDENTIALS
を、サービス アカウント キーが含まれる JSON ファイルのパスに設定します。 この変数は現在のシェル セッションにのみ適用されるため、新しいセッションを開く場合は、変数を再度設定します。
Cloud Shell
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 で使用するには、次の操作を行います。
クライアント ライブラリ
Google Cloud Game Servers は、クライアント ライブラリを使用して、プログラムで制御できます。ライブラリと認証の手順については、クライアント ライブラリの概要をご覧ください。
クラスタの削除
Game Servers クラスタを削除しても、クラスタ内のリソースは削除されません。
Console
Cloud Console で、[レルムとクラスタ] ページに移動します。
レルムを展開して、レルムに所属するゲームサーバー クラスタを確認します。
クラスタの最後のテーブル列で、省略記号 more_vert をクリックし、[ゲームサーバー クラスタを削除] を選択します。
gcloud
Google Cloud CLI を使用して、Game Servers のグローバル クラスタまたはリージョン クラスタを削除できます。
グローバル クラスタを削除するには:
次のコマンドを実行します。clusterID や realmID などのプレースホルダ値は、適切な値に置き換えます。
gcloud game servers clusters delete clusterID --realm=realmID --dry-run
クラスタを削除する前にオペレーションをプレビューできるように、出力では
targetState
が返されます。クラスタを削除するには、次のコマンドを実行します。
gcloud game servers clusters delete clusterID --realm=realmID --no-dry-run
リージョン クラスタを削除するには:
次のコマンドを実行します。clusterID などのプレースホルダの値は、適切な値に置き換えます。
gcloud game servers clusters delete clusterID --realm=realmID --location=region --dry-run
クラスタを削除する前にオペレーションをプレビューできるように、出力では
targetState
が返されます。クラスタを削除するには、次のコマンドを実行します。
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 }
C#
Game Servers のクライアント ライブラリをインストールして使用する方法については、Game Servers クライアント ライブラリをご覧ください。
Go
Game Servers のクライアント ライブラリをインストールして使用する方法については、Game Servers クライアント ライブラリをご覧ください。
Java
Game Servers のクライアント ライブラリをインストールして使用する方法については、Game Servers クライアント ライブラリをご覧ください。
Node.js
Game Servers のクライアント ライブラリをインストールして使用する方法については、Game Servers クライアント ライブラリをご覧ください。
Python
Game Servers のクライアント ライブラリをインストールして使用する方法については、Game Servers クライアント ライブラリをご覧ください。
クラスタが削除されたことを確認する
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 の概要の主なコンセプトについて学習する。