クラスタの削除

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

始める前に

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

Game Services API が有効になっていることを確認します。

Game Services API を有効にする

Cloud SDK がインストールされたシェルを選択するか、API クライアントを使用します。

Cloud Shell

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

Google Cloud Console に移動します。

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

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

ローカルシェル

gcloud をインストールするには、Cloud SDK をインストールします。これには、gcloud コマンドラインツールが含まれています。

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

gcloud config list project

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

gcloud config set project PROJECT_ID

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

gcloud version

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

gcloud components update

curl / PowerShell

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

サービスアカウントを作成する。
秘密鍵を JSON ファイルとしてダウンロードします。
環境変数 GOOGLE_APPLICATION_CREDENTIALS を、サービスアカウントキーが含まれる JSON ファイルのパスに設定します。この変数は現在のシェルセッションにのみ適用されるため、新しいセッションを開く場合は、変数を再度設定します。
例: Linux または macOS
```
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
KEY_PATH をサービスアカウントキーが含まれる JSON ファイルのパスに置き換えます。

例:
```
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
```
例: Windows

PowerShell の場合:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
KEY_PATH をサービスアカウントキーが含まれる JSON ファイルのパスに置き換えます。

例:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
```
コマンドプロンプトの場合:
```
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
```
KEY_PATH をサービスアカウントキーが含まれる JSON ファイルのパスに置き換えます。

クライアントライブラリ

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

クラスタの削除

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

Console

Cloud Console で、[レルムとクラスタ] ページに移動します。

Game Servers に移動
レルムを展開して、レルムに所属するゲームサーバークラスタを確認します。
クラスタの最後のテーブル列で、省略記号をクリックし、[ゲームサーバークラスタを削除] を選択します。

gcloud

Game Servers のグローバルクラスタまたはリージョンクラスタを削除するには、gcloud コマンドラインツールを使用します。

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

次のコマンドを実行します。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: クラスタのユーザー定義の識別子。

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

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

curl -X DELETE \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
"https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/REALM_LOCATION/realms/REALM_ID/gameServerClusters/GS_CLUSTER_ID"

PowerShell（Windows）

次のコマンドを実行します。

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

Invoke-WebRequest `
  -Method DELETE `
  -Headers $headers `
  -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/REALM_LOCATION/realms/REALM_ID/gameServerClusters/GS_CLUSTER_ID" | Select-Object -Expand Content

次のような 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
}

Go

Game Servers のクライアントライブラリをインストールして使用する方法については、Game Servers クライアントライブラリをご覧ください。

GitHub で表示フィードバック


import (
	"context"
	"fmt"
	"io"

	gaming "cloud.google.com/go/gaming/apiv1"
	gamingpb "google.golang.org/genproto/googleapis/cloud/gaming/v1"
)

// deleteCluster unregisters a game server cluster.
func deleteCluster(w io.Writer, projectID, location, realmID, clusterID string) error {
	// projectID := "my-project"
	// location := "global"
	// realmID := "myrealm"
	// clusterID := "mycluster"
	ctx := context.Background()
	client, err := gaming.NewGameServerClustersClient(ctx)
	if err != nil {
		return fmt.Errorf("NewGameServerClustersClient: %v", err)
	}
	defer client.Close()

	req := &gamingpb.DeleteGameServerClusterRequest{
		Name: fmt.Sprintf("projects/%s/locations/%s/realms/%s/gameServerClusters/%s", projectID, location, realmID, clusterID),
	}

	op, err := client.DeleteGameServerCluster(ctx, req)
	if err != nil {
		return fmt.Errorf("DeleteGameServerCluster: %v", err)
	}
	err = op.Wait(ctx)
	if err != nil {
		return fmt.Errorf("Wait: %v", err)
	}

	fmt.Fprintf(w, "Cluster deleted.")
	return nil
}

Java

Game Servers のクライアントライブラリをインストールして使用する方法については、Game Servers クライアントライブラリをご覧ください。

GitHub で表示フィードバック


import com.google.api.gax.longrunning.OperationFuture;
import com.google.cloud.gaming.v1.GameServerClustersServiceClient;
import com.google.cloud.gaming.v1.OperationMetadata;
import com.google.protobuf.Empty;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class DeleteCluster {

  public static void deleteGameServerCluster(
      String projectId, String regionId, String realmId, String clusterId)
      throws IOException, InterruptedException, ExecutionException, TimeoutException {
    // String projectId = "your-project-id";
    // String regionId = "us-central1-f";
    // String clusterId = "your-game-server-cluster-id";
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the "close" method on the client to safely clean up any remaining background resources.
    try (GameServerClustersServiceClient client = GameServerClustersServiceClient.create()) {
      String parent =
          String.format("projects/%s/locations/%s/realms/%s", projectId, regionId, realmId);
      String clusterName = String.format("%s/gameServerClusters/%s", parent, clusterId);

      OperationFuture<Empty, OperationMetadata> call =
          client.deleteGameServerClusterAsync(clusterName);

      call.get(1, TimeUnit.MINUTES);
      System.out.println("Game Server Cluster deleted: " + clusterName);
    }
  }
}

Node.js

Game Servers のクライアントライブラリをインストールして使用する方法については、Game Servers クライアントライブラリをご覧ください。

GitHub で表示フィードバック

const {
  GameServerClustersServiceClient,
} = require('@google-cloud/game-servers');

const client = new GameServerClustersServiceClient();

async function deleteGameServerCluster() {
  /**
   * TODO(developer): Uncomment these variables before running the sample.
   */
  // const projectId = 'Your Google Cloud Project ID';
  // const location = 'A Compute Engine region, e.g. "us-central1"';
  // const realmId = 'The ID of the realm to locate this cluster in';
  // const gameClusterId = 'The unique ID for this Game Server Cluster';
  const request = {
    // Provide full resource name of a Game Server Realm
    name: client.gameServerClusterPath(
      projectId,
      location,
      realmId,
      gameClusterId
    ),
  };

  const [operation] = await client.deleteGameServerCluster(request);
  await operation.promise();

  console.log('Game Server cluster deleted');
}

deleteGameServerCluster();

Python

Game Servers のクライアントライブラリをインストールして使用する方法については、Game Servers クライアントライブラリをご覧ください。

GitHub で表示フィードバック

def delete_cluster(project_id, location, realm_id, cluster_id):
    """Deletes a game server cluster."""

    client = gaming.GameServerClustersServiceClient()

    request = game_server_clusters.DeleteGameServerClusterRequest(
        name=f"projects/{project_id}/locations/{location}/realms/{realm_id}/gameServerClusters/{cluster_id}",
    )

    operation = client.delete_game_server_cluster(request)
    print(f"Delete cluster operation: {operation.operation.name}")
    operation.result(timeout=120)

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

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

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

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 の概要の主なコンセプトについて学習する。

クラスタの削除

始める前に

Cloud Shell

ローカルシェル

curl / PowerShell

クライアント ライブラリ

クラスタの削除

Console

gcloud

REST とコマンドライン

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

Go

Java

Node.js

Python

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

次のステップ

クライアントライブラリ