プライベートクラウドのリソースとアクティビティを管理する

プライベートクラウドを作成すると、その詳細情報の表示、リソースとアクティビティの管理、VMware 管理用アプライアンスへのアクセスが可能になります。各プライベートクラウドには 1 つ以上のクラスタが含まれ、各クラスタには ESXi ホストに対応するノードが含まれます。

プライベートクラウドのリストを表示するには、まずリソースの概要ページにアクセスします。

Google Cloud コンソールで、[プライベートクラウド] ページに移動します。

[プライベートクラウド] に移動
プライベートクラウドのリストから、管理するプライベートクラウドを選択します。

gcloud と API の要件

gcloud コマンドラインツールまたは API を使用して VMware Engine リソースを管理するには、以下で説明するようにツールを構成することをおすすめします。

gcloud

デフォルトのプロジェクト ID を設定します。
```
gcloud config set project PROJECT_ID
```

デフォルトのリージョンとゾーンを設定します。

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

gcloud vmware ツールの詳細については、Cloud SDK リファレンスドキュメントをご確認ください。

API

このドキュメントセットの API の例では、cURL コマンドラインツールを使用して API がクエリされています。cURL リクエストには、有効なアクセストークンが必要です。有効なアクセストークンを取得するにはさまざまな方法があります。次の手順では、gcloud ツールを使用してアクセストークンを生成します。

Google Cloud にログインします。
```
gcloud auth login
```
アクセストークンを生成して TOKEN にエクスポートします。
```
export TOKEN=`gcloud auth print-access-token`
```
TOKEN が正しく設定されていることを確認します。
```
echo $TOKEN
```

API へのリクエストで認証トークンを使用します。次に例を示します。

curl -X GET -H "Authorization: Bearer \"$TOKEN\"" -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations

Python

このドキュメントの Python コードサンプルは、VMware Engine ライブラリを使用して API と通信します。このアプローチを使用するには、ライブラリをインストールし、アプリケーションのデフォルト認証情報を構成する必要があります。

Python ライブラリをダウンロードしてインストールします。
```
pip install google-cloud-vmwareengine
```
シェルで次のコマンドを実行して、ADC 情報を構成します。
```
gcloud auth application-default login
```
または、サービスアカウントキーファイルを使用します。
```
export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
```

ライブラリの詳細については、リファレンスページまたは GitHub のコードサンプルをご覧ください。

IP アドレスのレイアウトバージョンを確認する

2022 年 11 月以降に作成されたプライベートクラウドには、IP アドレスレイアウト（IP プラン）バージョン 2.0 のサブネット割り振りが適用されます。2022 年 11 月より前に作成されたほとんどのプライベートクラウドには、IP プランバージョン 1.0 のサブネット割り振りが適用されます。

プライベートクラウドが準拠しているバージョンを確認するには、次の手順を完了します。

Google Cloud コンソールで、[プライベートクラウド] ページに移動します。

[プライベートクラウド] に移動
確認するプライベートクラウドの名前を選択します。バージョン番号は [IP プランバージョン] とともに表示されます。

プライベートクラウドの概要の表示

概要には、名前、vSphere クラスタの数、ノード数、ロケーション、運用状態など、プライベートクラウドに関する情報が表示されます。概要ページには、プライベートクラウドにデプロイされた DNS サーバーが含まれます。

プライベートクラウドの概要ページから、次の操作を行えます。

vSphere クライアントの起動。このプライベートクラウドの vCenter にアクセスします。
ノードの追加。。このプライベートクラウドにノードを追加します。
クラスタの追加。このプライベートクラウドに新しいクラスタを追加します。
カスタムコア数の構成を設定したクラスタの作成。カスタムコア数の構成を設定した新しいクラスタを作成します。
ノードの削除。このプライベートクラウドからノードを削除します。
プライベートクラウドの削除。すべての VM、vCenter 構成、データを含むプライベートクラウドを削除します。削除する前に、すべてのシステムとデータをバックアップしてください。
vSphere 権限の変更。このプライベートクラウド上で特定のタスクを実行するように権限を昇格させます。
DNS サーバーの IP アドレスのコピー。プライベートクラウドの DNS サーバーのリストを取得します。オンプレミスの DNS サーバーからプライベートクラウド DNS サーバーへの DNS 転送を設定できます。DNS 転送の詳細については、オンプレミスワークステーションからプライベートクラウド vCenter へアクセスするための名前解決用 DNS を構成するをご覧ください。

プライベートクラウドへのノードの追加

プライベートクラウドは、1 つ以上の vSphere クラスタで構成され、各クラスタには複数のノードが含まれています。プライベートクラウドにノードを追加する場合は、既存のクラスタにノードを追加するか、新しいクラスタを作成します。プライベートクラウドは、全体のノード上限を超えない限り何度でも拡張できます。プライベートクラウドを拡張するたびに、既存のクラスタに追加するか、新しいクラスタを作成します。

新しいクラスタ構成の一部として、Google は VMware インフラストラクチャを構成します。この設定には、vSAN ディスクグループ、VMware 高可用性、分散リソーススケジューラ（DRS）のストレージ設定が含まれます。

コンソール

Google Cloud コンソールを使用してプライベートクラウドにノードを追加するには、次の手順で操作します。

Google Cloud コンソールで、[プライベートクラウド] ページに移動します。

[プライベートクラウド] に移動
[プライベートクラウド] の概要ページで、[ノードを追加] をクリックします。
既存のクラスタの 1 つにノードを追加するか、新しい vSphere クラスタを作成するかを選択します。変更を加えると、そのページの概要情報が更新されます。
既存のいずれかのクラスタにノードを追加するには、[Add nodes to existing] を選択します。拡張するクラスタを選択して、追加するノードの数を入力します。
新しいクラスタを追加するには、[Create new] を選択します。続いて、次の詳細情報を指定します。
1. クラスタの名前を入力します。
2. 既存の vSphere データセンターを選択するか、新しいデータセンターを作成するための名前を入力します。
3. ノード数を選択します。新しいクラスタごとに最低 3 つのノードが必要です。
4. 省略可: 管理クラスタ内の各ノードで使用可能なコア数を減らすには、[Customize Cores] トグルをクリックします。詳細については、カスタムコア数をご覧ください。
[送信] をクリックします。

gcloud

update コマンドを使用すると、クラスタの合計ノード数を変更できます。このコマンドには、クラスタとプライベートクラウドの名前が必要です。

gcloud vmware private-clouds clusters list コマンドを入力して、クラスタを一覧表示します。
```
gcloud vmware private-clouds clusters list \
--private-cloud=PRIVATE_CLOUD_ID \
--location=ZONE
```

以下のように置き換えます。

PRIVATE_CLOUD_ID: プライベートクラウドの名前
ZONE: プライベートクラウドのゾーン

次の gcloud vmware private-clouds clusters update コマンドを実行して、クラスタを更新します。
```
gcloud vmware private-clouds clusters update CLUSTER_ID \
--location=ZONE \
--private-cloud=PRIVATE_CLOUD_ID \
--update-nodes-config=type=NODE_TYPE,count=NODE_COUNT
```
以下のように置き換えます。
- CLUSTER_ID: このプライベートクラウドで更新するクラスタ ID。
- ZONE: プライベートクラウドのゾーン
- PRIVATE_CLOUD_ID: このリクエストのプライベートクラウド ID。
- NODE_TYPE: ノードタイプ。詳細については、ノードタイプをご覧ください。
- NODE_COUNT: 追加するノードの数。

API

更新 API を使用すると、クラスタの合計ノード数を変更できます。このコマンドには、クラスタとプライベートクラウドの名前が必要です。

GET リクエストを送信して、クラスタを一覧表示します。

curl -L -X GET -H "Authorization: Bearer TOKEN" "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters"

以下のように置き換えます。

PROJECT_ID: このリクエストのプロジェクト ID
ZONE: プライベートクラウドのゾーン
PRIVATE_CLOUD_ID: このリクエストのプライベートクラウド ID

PATCH リクエストを送信して、クラスタを更新します。たとえば、次のコマンドはクラスタを standard-72 ノードタイプに更新します。
```
curl -L -X PATCH -H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID?updateMask=node_type_configs.*.node_count" \
-d '{
"nodeTypeConfigs": {
  "standard-72" : {
    "nodeCount": NODE_COUNT
  }
}
}'
```
以下のように置き換えます。
- PROJECT_ID: このリクエストのプロジェクト ID
- ZONE: プライベートクラウドのゾーン
- PRIVATE_CLOUD_ID: プライベートクラウドのプライベートクラウド ID
- CLUSTER_ID: このプライベートクラウドで更新するクラスタのクラスタ ID
- NODE_COUNT: 追加するノードの数

Python

クラスタの更新メソッドを使用して、クラスタの合計ノード数を変更できます。このメソッドには、クラスタとプライベートクラウドの名前が必要です。

クラスタを一覧表示します。

from typing import Iterable

from google.cloud import vmwareengine_v1


def list_clusters(
    project_id: str, zone: str, private_cloud_name: str
) -> Iterable[vmwareengine_v1.Cluster]:
    """
    Retrieves a list of clusters in private cloud.

    Args:
        project_id: name of the project hosting the private cloud.
        zone: zone in which the private cloud is located.
        private_cloud_name: name of the cloud of which you want to list cluster.

    Returns:
        An iterable collection of Cluster objects.
    """
    client = vmwareengine_v1.VmwareEngineClient()
    return client.list_clusters(
        parent=f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )

クラスタを更新します。次のメソッドを使用すると、クラスタ内の standard-72 ノードの数を変更できます。

from google.api_core import operation
from google.cloud import vmwareengine_v1


def update_cluster_node_count(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int,
) -> operation.Operation:
    """
    Modify the number of nodes in a cluster in a private cloud.

    Modifying a cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: zone in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the cluster.
        cluster_name: name of the cluster.
        node_count: desired number of nodes in the cluster.

    Returns:
        An Operation object related to cluster modification operation.
    """
    if node_count < 3:
        raise RuntimeError("Cluster needs to have at least 3 nodes")
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.UpdateClusterRequest()
    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
        f"/clusters/{cluster_name}"
    )
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count
    request.update_mask = "nodeTypeConfigs.*.nodeCount"
    return client.update_cluster(request)

プライベートクラウドに新しいクラスタを追加する

既存のプライベートクラウドに新しいクラスタを追加する手順は次のとおりです。

gcloud

gcloud vmware private-clouds clusters create コマンドを実行して、新しいクラスタを追加して名前を付けます。たとえば、次のようにします。

gcloud vmware private-clouds clusters create CLUSTER_ID \
   --location=ZONE \
   --private-cloud=PRIVATE_CLOUD_ID \
   --node-type-config=type=NODE_TYPE,count=NODE_COUNT

以下のように置き換えます。

CLUSTER_ID: プライベートクラウドに追加するクラスタのクラスタ ID。
ZONE: プライベートクラウドのゾーン
PRIVATE_CLOUD_ID: プライベートクラウドのプライベートクラウド ID。
NODE_TYPE: ノードタイプ。詳細については、ノードタイプをご覧ください。
NODE_COUNT: 追加するノードの数。

API

POST リクエストを実行して、新しいクラスタを作成して名前を付けます。次に例を示します。

curl -L -X POST -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters?clusterId=CLUSTER_ID" \
-d '{
  "nodeTypeConfigs": {
    "standard-72": {
      "nodeCount": NODE_COUNT
      }
  }
}'

以下のように置き換えます。

CLUSTER_ID: プライベートクラウドに追加するクラスタのクラスタ ID
ZONE: プライベートクラウドのゾーン
PRIVATE_CLOUD_ID: プライベートクラウドのプライベートクラウド ID
NODE_COUNT: 追加するノードの数

Python

新しいクラスタを追加して名前を付けます。

from google.api_core import operation
from google.cloud import vmwareengine_v1


def create_cluster(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int = 4,
) -> operation.Operation:
    """
    Create a new cluster in a private cloud.

    Creation of a new cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: region in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the new cluster.
        cluster_name: name of the new cluster.
        node_count: number of nodes in the new cluster. (Must be >= 3)

    Returns:
        An Operation object related to started cluster creation operation.

    Raises:
        ValueError in case an incorrect number of nodes is provided.
    """
    if node_count < 3:
        raise ValueError("Cluster needs to have at least 3 nodes")

    request = vmwareengine_v1.CreateClusterRequest()
    request.parent = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )

    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = cluster_name

    # Currently standard-72 is the only supported node type.
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count

    client = vmwareengine_v1.VmwareEngineClient()
    return client.create_cluster(request)

カスタムコア数の構成を設定した新しいクラスタを作成する

カスタムコア数の構成を設定した新しいクラスタを作成するには、次の手順に従います。

gcloud

gcloud vmware private-clouds clusters create コマンドを実行して、新しいクラスタを追加し、コア数の構成を指定します。次の例では、standard-72 ノードタイプの新しいクラスタを作成します。

gcloud vmware private-clouds clusters create CLUSTER_ID \
  --location=ZONE \
  --private-cloud=PRIVATE_CLOUD_ID \
  --node-type-config=type=standard-72,count=NODE_COUNT,custom-core-count=CORE_COUNT

以下のように置き換えます。

CLUSTER_ID: プライベートクラウドに追加するクラスタのクラスタ ID
ZONE: プライベートクラウドのゾーン
PRIVATE_CLOUD_ID: プライベートクラウドのプライベートクラウド ID
NODE_COUNT: 追加するノードの数
CORES_COUNT: 追加するカスタムコアの数

API

POST リクエストを実行して、新しいクラスタを追加し、コア数の構成を指定します。次の例では、standard-72 ノードタイプの新しいクラスタを作成します。

curl -L -X POST -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters?clusterId=CLUSTER_ID" \
-d '{
      "nodeTypeConfigs": {
      "standard-72": {
        "nodeCount": NODE_COUNT,
        "customCoreCount": CORE_COUNT
        }
    }
}'

以下のように置き換えます。

PROJECT_ID: プライベートクラウドのプロジェクト ID
CLUSTER_ID: プライベートクラウドに追加するクラスタのクラスタ ID
ZONE: プライベートクラウドのゾーン
PRIVATE_CLOUD_ID: プライベートクラウドのプライベートクラウド ID
NODE_COUNT: 追加するノードの数
CORES_COUNT: 追加するカスタムコアの数

Python

新しいクラスタを追加し、コア数の構成を指定します。たとえば、次の例では、構成可能なノード数とコア数が設定された standard-72 ノードタイプの新しいクラスタを作成します。

from google.api_core import operation
from google.cloud import vmwareengine_v1


def create_custom_cluster(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int = 4,
    core_count: int = 28,
) -> operation.Operation:
    """
    Create a new cluster with custom number of cores in its nodes
    in a private cloud.

    Creation of a new cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: region in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the new cluster.
        cluster_name: name of the new cluster.
        node_count: number of nodes in the new cluster.
        core_count: number of CPU cores in the new cluster nodes.

    Returns:
        An Operation object related to started cluster creation operation.

    Raises:
        ValueError in case an incorrect number of nodes is provided.
    """
    if node_count < 3:
        raise ValueError("Cluster needs to have at least 3 nodes")

    request = vmwareengine_v1.CreateClusterRequest()
    request.parent = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )

    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = cluster_name

    # Currently standard-72 is the only supported node type.
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count
    request.cluster.node_type_configs["standard-72"].custom_core_count = core_count

    client = vmwareengine_v1.VmwareEngineClient()
    return client.create_cluster(request)

ノードを削除する、またはクラスタを削除する

プライベートクラウドからノードを削除する場合は、既存のクラスタからノードを削除するか、クラスタ全体を削除します。

コンソール

Google Cloud コンソールを使用してノード数の少ないプライベートクラウドからノードを削除するには、次の手順を行います。

Google Cloud コンソールで、[プライベートクラウド] ページに移動します。

[プライベートクラウド] に移動
[プライベートクラウド] の概要ページで、[ノードを削除] をクリックします。
縮小または削除するクラスタを選択します。
[1 つのノードを削除] をクリックします。
クラスタの容量を確認します。
[Submit] をクリックすると、ノードの削除プロセスが開始されます。

進行状況をモニタリングするには、[Activity] > [Tasks] の順に選択します。このプロセスでは、vSAN での再同期が必要であり、データによっては数時間かかることがあります。

gcloud

Google Cloud CLI を使用してプライベートクラウドからノードを削除するには、gcloud vmware private-clouds clusters update コマンドを使用します。

gcloud vmware private-clouds clusters update CLUSTER_ID \
  --location=ZONE \
  --private-cloud=PRIVATE_CLOUD_ID \
  --update-nodes-config=type=NODE_TYPE,count=NODE_COUNT

以下のように置き換えます。

CLUSTER_ID: このプライベートクラウドで更新するクラスタのクラスタ ID。
ZONE: プライベートクラウドのゾーン
PRIVATE_CLOUD_ID: プライベートクラウドのプライベートクラウド ID。
NODE_TYPE: ノードタイプ。詳細については、ノードタイプをご覧ください。
NODE_COUNT: 新しいノード数。この新しい値は、現在の値よりも 1 つ小さい値にする必要があります。

API

VMware Engine API を使用してプライベートクラウドからノードを削除するには、PATCH リクエストを実行します。

curl -L -X PATCH -H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID?update_mask=node_type_configs.*.node_count" \
-d '{
  "nodeTypeConfigs": {
    "standard-72" : {
      "nodeCount": NODE_COUNT
    }
  }
}'

以下のように置き換えます。

CLUSTER_ID: このプライベートクラウドで更新するクラスタのクラスタ ID
ZONE: プライベートクラウドのゾーン
PRIVATE_CLOUD_ID: プライベートクラウドのプライベートクラウド ID
NODE_COUNT: 新しいノード数。この新しい値は、現在の値よりも 1 つ小さい値にする必要があります。

Python

from google.api_core import operation
from google.cloud import vmwareengine_v1


def update_cluster_node_count(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int,
) -> operation.Operation:
    """
    Modify the number of nodes in a cluster in a private cloud.

    Modifying a cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: zone in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the cluster.
        cluster_name: name of the cluster.
        node_count: desired number of nodes in the cluster.

    Returns:
        An Operation object related to cluster modification operation.
    """
    if node_count < 3:
        raise RuntimeError("Cluster needs to have at least 3 nodes")
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.UpdateClusterRequest()
    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
        f"/clusters/{cluster_name}"
    )
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count
    request.update_mask = "nodeTypeConfigs.*.nodeCount"
    return client.update_cluster(request)

クラスタの削除

クラスタ全体を削除するには、次の操作を行います。

コンソール

Google Cloud コンソールで、[プライベートクラウド] ページに移動します。

[プライベートクラウド] に移動
[プライベートクラウド] の概要ページで、[ノードを削除] をクリックします。
縮小または削除するクラスタを選択します。
[Delete the whole cluster] を選択します。
クラスタの容量を確認します。
[Submit] をクリックすると、ノードの削除プロセスが開始されます。

gcloud

Google Cloud CLI を使用してクラスタ全体を削除するには、gcloud vmware private-clouds clusters delete コマンドを使用します。

gcloud vmware private-clouds clusters delete CLUSTER_ID \
  --location=ZONE \
  --private-cloud=PRIVATE_CLOUD_ID

以下のように置き換えます。

CLUSTER_ID: このプライベートクラウドで更新するクラスタのクラスタ ID
ZONE: プライベートクラウドのゾーン
PRIVATE_CLOUD_ID: プライベートクラウドのプライベートクラウド ID

API

VMware Engine API を使用してクラスタ全体を削除するには、DELETE リクエストを実行します。

curl -L -X DELETE -H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID"

以下のように置き換えます。

PROJECT_ID: プライベートクラウドのプロジェクト ID
ZONE: プライベートクラウドのゾーン
PRIVATE_CLOUD_ID: プライベートクラウドのプライベートクラウド ID
CLUSTER_ID: このプライベートクラウドで更新するクラスタのクラスタ ID

Python

from google.api_core import operation
from google.cloud import vmwareengine_v1


def delete_cluster(
    project_id: str, zone: str, private_cloud_name: str, cluster_name: str
) -> operation.Operation:
    """
    Delete a cluster from private cloud.

    Deleting a cluster is a long-running operation and it may take over an hour..

    Args:
        project_id: name of the project you want to use.
        zone: region in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the new cluster.
        cluster_name: name of the new cluster.

    Returns:
        An Operation object related to started cluster deletion operation.
    """
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.DeleteClusterRequest()
    request.name = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
        f"/clusters/{cluster_name}"
    )
    return client.delete_cluster(request)

ノードの一覧表示

Google Cloud コンソール、Google Cloud CLI、または VMware Engine API を使用して、特定のプライベートクラウドのクラスタのノードを一覧表示し、複数のノードや特定のノードに関する情報を取得するには、次の手順を行います。

コンソール

Google Cloud コンソールを使用して 1 つ以上のプライベートクラウドのノードを一覧表示するには、次の手順を行います。

Google Cloud コンソールで、[プライベートクラウド] ページに移動します。

[プライベートクラウド] に移動
プライベートクラウドの概要ページで、プライベートクラウドの名前をクリックします。
[クラスタの詳細] ページで [クラスタ] タブをクリックします。
[クラスタ] タブで、クラスタの名前をクリックします。クラスタ内のすべてのノードがクラスタノードテーブルに表示されます。

gcloud

Google Cloud CLI を使用して 1 つ以上のプライベートクラウドのノードを一覧表示する手順は次のとおりです。

gcloud vmware private-clouds clusters node list コマンドを実行して、特定のプライベートクラウドの PRIVATE_CLOUD_ID にバインドされているすべてのノードを一覧表示します。
```
gcloud vmware private-clouds clusters node list \
 --project=PROJECT_ID\
 --location=ZONE \
 --private-cloud=PRIVATE_CLOUD_ID \
 --cluster=CLUSTER_ID
```
以下のように置き換えます。
- PROJECT_ID: このリクエストのプロジェクト名。
- ZONE: VM を配置するゾーン。
- PRIVATE_CLOUD_ID: このリクエストのネットワーク ID。
- CLUSTER_ID: このリクエストのクラスタ ID。

API

VMware Engine API を使用して 1 つ以上のプライベートクラウドのノードを一覧表示するには、次の操作を行います。

GET リクエストを行って、特定のプライベートクラウドの PRIVATE_CLOUD_ID にバインドされているすべてのノードを一覧表示します。
```
GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes"
```
以下のように置き換えます。
- PROJECT_ID: このリクエストのプロジェクト名。
- ZONE: VM を配置するゾーン。
- PRIVATE_CLOUD_ID: このリクエストのネットワーク ID。
- CLUSTER_ID: このリクエストのクラスタ ID。

ノードの説明を生成する

Google Cloud Console、Google Cloud CLI、または VMware Engine API を使用してノードの説明を取得するには、次の手順を行います。

コンソール

Google Cloud コンソールを使用して 1 つ以上のプライベートクラウドのノードを一覧表示するには、次の手順を行います。

Google Cloud コンソールで、[プライベートクラウド] ページに移動します。

[プライベートクラウド] に移動
プライベートクラウドの概要ページで、プライベートクラウドの名前をクリックします。
[クラスタの詳細] ページで [クラスタ] タブをクリックします。
[クラスタ] タブで、クラスタの名前をクリックします。ノードの詳細はクラスタノードテーブルに表示されます。

gcloud

Google Cloud CLI を使用してノードの説明を取得する場合。

省略可: gcloud vmware private-clouds clusters node list コマンドを実行してノードの名前を確認します。
```
gcloud vmware private-clouds clusters node list \
 --project=PROJECT_ID\
 --location=ZONE \
 --private-cloud=PRIVATE_CLOUD_ID \
 --cluster=CLUSTER_ID
```
以下のように置き換えます。
- PROJECT_ID: このリクエストのプロジェクト名。
- ZONE: VM を配置するゾーン。
- PRIVATE_CLOUD_ID: このリクエストのネットワーク ID。
- CLUSTER_ID: このリクエストのクラスタ ID。
gcloud vmware private-clouds clusters nodes describe コマンドを実行して、特定のノードの説明を取得します。
```
gcloud vmware private-clouds clusters nodes describe NODE_NAME \
 --project=PROJECT_ID\
 --location=ZONE \
 --private-cloud=PRIVATE_CLOUD_ID \
 --cluster=CLUSTER_ID
```
以下のように置き換えます。
- NODE_NAME: 前のコマンドで返されたノード名。たとえば、esxi-1435-f4d250 です。
- PROJECT_ID: このリクエストのプロジェクト名。
- ZONE: VM を配置するゾーン。
- PRIVATE_CLOUD_ID: このリクエストのネットワーク ID。
- CLUSTER_ID: このリクエストのクラスタ ID。

API

VMware Engine API を使用してノードの説明を取得する場合。

省略可: GET リクエストを実行してノードの名前を確認します。
```
GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes"
```
以下のように置き換えます。
- PROJECT_ID: このリクエストのプロジェクト名。
- ZONE: VM を配置するゾーン。
- PRIVATE_CLOUD_ID: このリクエストのネットワーク ID。
- CLUSTER_ID: このリクエストのクラスタ ID。
特定のノードの説明を取得するには、GET リクエストを行います。
```
GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes/NODE_NAME"
```
以下のように置き換えます。
- NODE_NAME: 前のコマンドで返されたノード名。たとえば、esxi-1435-f4d250 です。
- PROJECT_ID: このリクエストのプロジェクト名。
- ZONE: VM を配置するゾーン。
- PRIVATE_CLOUD_ID: このリクエストのネットワーク ID。
- CLUSTER_ID: このリクエストのクラスタ ID。

制限事項

プライベートクラウドからノードを削除するプロセスには、次の制約があります。

vSphere クラスタには 3 つ以上のノードが必要です。ノード数が 3 つの vSphere クラスタからノードを削除することはできません。
Google Cloud コンソール、gcloud CLI、VMware Engine API のいずれを使用しても、ノードの削除リクエストごとに一度に 1 つのノードしか削除できません。
使用した総容量は、クラスタからノードを削除した後の合計容量を超えることはありません。
プライベートクラウドの作成時に作成された最初のクラスタは削除できません。
vSphere DRS ルール（アフィニティと反アフィニティ）がクラスタのすべてのノードに適用されている場合、クラスタからノードを削除することはできません。ルールを削除して、ノード削除オペレーションを再試行できます。

サブネットの表示

プライベートクラウド用に定義された管理サブネットのリストを表示するには、[Subnets] タブを選択します。このリストには、プライベートクラウドの作成時に作成された HCX サブネットが含まれます。

アクティビティ情報の表示

プライベートクラウドのアクティビティ情報を表示するには、[ログビューアに移動] をクリックします。アクティビティとそれらに関連する操作の全一覧については、VMware Engine アクティビティのモニタリングをご覧ください。

vSphere 管理ネットワークの表示

プライベートクラウドで構成されている VMware 管理リソースと仮想マシンのリストを表示するには、[vSphere Management Network] タブを選択します。情報には、ソフトウェアバージョン、完全修飾ドメイン名（FQDN）、リソースの IP アドレスが含まれます。

プライベート クラウドのリソースとアクティビティを管理する

gcloud と API の要件

gcloud

API

Python

IP アドレスのレイアウト バージョンを確認する

プライベート クラウドの概要の表示

プライベート クラウドへのノードの追加

コンソール

gcloud

API

Python

プライベート クラウドに新しいクラスタを追加する

gcloud

API

Python

カスタムコア数の構成を設定した新しいクラスタを作成する

gcloud

API

Python

ノードを削除する、またはクラスタを削除する

コンソール

gcloud

API

Python

クラスタの削除

コンソール

gcloud

API

Python

ノードの一覧表示

コンソール

gcloud

API

ノードの説明を生成する

コンソール

gcloud

API

制限事項

サブネットの表示

アクティビティ情報の表示

vSphere 管理ネットワークの表示

プライベートクラウドのリソースとアクティビティを管理する

IP アドレスのレイアウトバージョンを確認する

プライベートクラウドの概要の表示

プライベートクラウドへのノードの追加

プライベートクラウドに新しいクラスタを追加する