レルムの削除

このページでは、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 は、クライアント ライブラリを使用して、プログラムで制御できます。ライブラリと認証の手順については、クライアント ライブラリの概要をご覧ください。

レルムの削除

Console

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

    Game Servers に移動

  2. フィルタ ボックスを使用して、レルムのリストをさまざまなプロパティでフィルタリングできます。

  3. 最後のテーブル列で、省略記号 をクリックして、[レルムを削除] を選択します。

gcloud

グローバルまたはリージョンのレルムを削除するには、Google Cloud CLI を使用します。

グローバル レルムを削除するには、次のコマンドを実行します。realmID は、以前に作成したレルム ID に置き換えます。

gcloud game servers realms delete realmID

リージョンのレルムを削除するには、次のコマンドを実行します。realmID などのプレースホルダの値を、適切な値に置き換えます。

gcloud game servers realms delete realmID --location=region

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

  • realmID は、一意のレルム ID です。
  • region は、レルムのリージョン（存在する場合）です。

REST

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

  • PROJECT_ID: IAM 設定に載っている Google Cloud プロジェクト ID。
  • LOCATION: レルムのリージョンまたは global。
  • REALM_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",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

レルムが削除されたことを確認する

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

すべてのグローバルのレルムを一覧表示するには、次のコマンドを実行します。

gcloud game servers realms list

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

gcloud game servers realms list --location=region

削除したレルムはコマンドの出力に表示されなくなります。

次のステップ

監査ログについて学習する。