Gerenciar recursos e atividades de nuvem privada

Depois de criar uma nuvem privada, é possível ver informações detalhadas sobre ela, gerenciar os recursos e a atividade e acessar os dispositivos de gerenciamento de VMware. Cada nuvem privada contém um ou mais clusters, e cada cluster contém nós que correspondem a hosts ESXi.

Para conferir uma lista das suas nuvens privadas, acesse a página de resumo dos recursos:

Vá para o console do Google Cloud.
Na navegação principal, clique em Nuvens privadas.
Selecione a nuvem particular que você quer gerenciar na lista de nuvens privadas.

gcloud e requisitos de API

Para usar a ferramenta de linha de comando gcloud ou a API para gerenciar os recursos do VMware Engine, recomendamos configurar as ferramentas conforme descrito abaixo.

gcloud

Defina o ID do projeto padrão:
```
gcloud config set project PROJECT_ID
```

Defina uma região e uma zona padrão.

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

Para mais informações sobre a ferramenta gcloud vmware, consulte os documentos de referência do SDK Cloud.

API

Os exemplos de API neste conjunto de documentação usam a ferramenta de linha de comando cURL para consultar a API. Um token de acesso válido é necessário como parte da solicitação cURL. Há muitas maneiras de conseguir um token de acesso válido. As etapas a seguir usam a ferramenta gcloud para gerar um token de acesso:

Faça login no Google Cloud:
```
gcloud auth login
```

Gere o token de acesso e exporte para o TOKEN:

export TOKEN=`gcloud auth print-access-token`

Verifique se o TOKEN está definido corretamente:
```
echo $TOKEN
```

Use agora o token de autorização nas solicitações para a API. Exemplo:

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

Os exemplos de código Python nesta documentação usam a biblioteca do VMware Engine para se comunicar com a API. Para usar essa abordagem, a biblioteca precisa estar instalada e o Application Default Credentials precisa estar configurado.

Faça o download e instale a biblioteca Python:
```
pip install google-cloud-vmwareengine
```
Configure as informações do ADC executando estes comandos no shell:
```
gcloud auth application-default login
```
Ou use um arquivo de chave da conta de serviço:
```
export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
```

Para mais informações sobre a biblioteca, acesse a página de referência ou veja os exemplos de código no GitHub.

Verificar a versão do layout de endereço IP

As nuvens privadas criadas após novembro de 2022 adotam as alocações de sub-rede do layout de endereço IP (plano IP) versão 2.0. Quase todas as nuvens privadas criadas antes de novembro de 2022 adotam as alocações de sub-rede do plano de IP versão 1.0.

Para saber qual versão sua nuvem privada adota, siga estas etapas:

Vá para o console do Google Cloud.
Na navegação principal, clique em Nuvens privadas.
Na página Nuvens privadas, selecione o nome da nuvem privada que você quer verificar. O número da versão é exibido com Versão do plano de IP.

Como visualizar um resumo privado na nuvem

O resumo fornece informações sobre a nuvem privada, incluindo nome, número de clusters do vSphere, número de nós, local, estado operacional e muito mais. A página de resumo inclui os servidores DNS implantados na nuvem privada.

Na página de resumo da nuvem particular, é possível realizar as seguintes ações:

Iniciar cliente do vSphere. Acesse o vCenter para esta nuvem privada.
Adicionar nós. Adicione nós a esta nuvem privada.
Adicionar cluster. Adicione um novo cluster a esta nuvem privada.
Criar um cluster com configuração de contagem de núcleos personalizados. Crie um novo cluster com configuração de contagem de núcleos personalizada
Remover nós. Remover nós desta nuvem privada.
Exclua a nuvem privada. Exclua uma nuvem privada, incluindo todas as VMs, a configuração do vCenter e os dados. Antes da exclusão, faça backup de todos os sistemas e dados.
Alterar privilégios do vSphere. Coloque seus privilégios para realizar uma tarefa específica nessa nuvem privada.
Copiar endereços IP de servidores DNS. Receba uma lista de servidores DNS na sua nuvem privada. É possível configurar o encaminhamento de DNS de servidores DNS locais para servidores DNS de nuvem privada. Para mais informações sobre encaminhamento de DNS, consulte Como configurar o DNS para resolução de nomes para acesso do vCenter de nuvem particular a partir de estações de trabalho locais.

Como adicionar nós a uma nuvem privada

Uma nuvem privada consiste em um ou mais clusters do vSphere, cada um contendo vários nós. Ao adicionar nós a uma nuvem particular, você adiciona nós ao cluster atual ou cria um novo cluster. Uma nuvem privada pode ser expandida várias vezes, desde que você esteja dentro dos limites gerais de nós. Toda vez que você expande uma nuvem privada, você adiciona ao cluster atual ou cria um novo.

Como parte da nova configuração do cluster, o Google configura a infraestrutura da VMware. As configurações incluem as configurações de armazenamento para grupos de discos vSAN, alta disponibilidade de VMware e programador de recursos distribuídos (DRS).

Console

Para adicionar nós a uma nuvem privada usando o console do Google Cloud, siga estas etapas:

Vá para o console do Google Cloud.
Na navegação principal, clique em Nuvens privadas.
Na página de resumo de nuvens privadas, clique em Adicionar nós.
Escolha se você quer adicionar nós a um dos clusters atuais ou criar um novo cluster do vSphere. A medida que você faz alterações, as informações resumidas na página são atualizadas.
Para adicionar nós a um dos clusters, selecione Adicionar nós a atuais. Selecione o cluster que você quer expandir e insira o número de nós a serem adicionados.
Para adicionar um novo cluster, selecione Criar novo. Em seguida, forneça os detalhes a seguir:
1. Digite um nome para o cluster.
2. Selecione um data center atual do vSphere ou insira um nome para criar um novo data center.
3. Selecione o número de nós. Cada novo cluster precisa ter pelo menos três nós.
4. Opcional: clique no botão Personalizar núcleos se você quiser reduzir o número de núcleos disponíveis para cada nó no cluster de gerenciamento. Para mais detalhes, consulte Contagens de núcleo personalizados.
Clique em Enviar.

gcloud

O comando Atualizar permite alterar a contagem total de nós do cluster. Esse comando requer o nome do cluster e da nuvem privada.

Liste os clusters inserindo o comando gcloud vmware private-clouds clusters list.

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

Substitua:

PRIVATE_CLOUD_ID: o nome da nuvem privada
ZONE: a zona da nuvem privada

Para atualizar o cluster, execute o comando 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=standard-72,count=NODE_COUNT
```
Substitua:
- CLUSTER_ID: o ID do cluster a ser atualizado nessa nuvem privada
- ZONE: a zona da nuvem privada
- PRIVATE_CLOUD_ID: o ID da nuvem privada da solicitação
- NODE_COUNT: o número de nós a serem adicionados

API

A API de atualização permite alterar a contagem total de nós do cluster. Esse comando requer o nome do cluster e da nuvem privada.

Liste os clusters fazendo uma solicitação GET:

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

Substitua:

PROJECT_ID: o ID do projeto desta solicitação
ZONE: a zona da nuvem privada
PRIVATE_CLOUD_ID: o ID da nuvem privada da solicitação

Atualize os clusters fazendo uma solicitação PATCH. Por exemplo, o comando a seguir atualiza o cluster para o tipo de nó 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
  }
}
}'
```
Substitua:
- PROJECT_ID: o ID do projeto desta solicitação
- ZONE: a zona da nuvem privada
- PRIVATE_CLOUD_ID: o ID da nuvem privada
- CLUSTER_ID: o ID do cluster a ser atualizado nessa nuvem privada
- NODE_COUNT: o número de nós a serem adicionados

Python

O método de atualização de cluster permite mudar a contagem total de nós. Esse método requer o nome do cluster e da nuvem privada.

Liste os clusters.

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}"
    )

Atualize os clusters. O método a seguir permite modificar o número de nós standard-72 no cluster.

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)

Adicionar um novo cluster a uma nuvem privada

Para adicionar um novo cluster a uma nuvem privada, faça o seguinte:

gcloud

Adicione o novo cluster e atribua um nome a ele executando o comando gcloud vmware private-clouds clusters create. Exemplo:

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

Substitua:

CLUSTER_ID: o ID do cluster que você está adicionando à nuvem privada
ZONE: a zona da nuvem privada
PRIVATE_CLOUD_ID: o ID da nuvem privada
NODE_COUNT: o número de nós a serem adicionados

API

Adicione o novo cluster e dê um nome a ele fazendo uma solicitação POST. Exemplo:

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
      }
  }
}'

Substitua:

CLUSTER_ID: o ID do cluster que você está adicionando à nuvem privada
ZONE: a zona da nuvem privada
PRIVATE_CLOUD_ID: o ID da nuvem privada
NODE_COUNT: o número de nós a serem adicionados

Python

Adicione o novo cluster e dê um nome a ele.

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)

Criar um cluster com configuração de contagem de núcleos personalizada

Para criar um novo cluster com a configuração personalizada de contagem de núcleos, faça o seguinte:

gcloud

Adicione o novo cluster e especifique a configuração da contagem de núcleos executando o comando gcloud vmware private-clouds clusters create. No exemplo a seguir, criamos um novo cluster com um tipo de nó 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

Substitua:

CLUSTER_ID: o ID do cluster que você está adicionando à nuvem privada
ZONE: a zona da nuvem privada
PRIVATE_CLOUD_ID: o ID da nuvem privada
NODE_COUNT: o número de nós a serem adicionados
CORES_COUNT: o número de núcleos personalizados a serem adicionados

API

Adicione o novo cluster e especifique a configuração da contagem de núcleos fazendo uma solicitação POST. No exemplo a seguir, criamos um novo cluster do tipo de nó 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
        }
    }
}'

Substitua:

PROJECT_ID: o ID do projeto da nuvem privada
CLUSTER_ID: o ID do cluster que você está adicionando à nuvem privada
ZONE: a zona da nuvem privada
PRIVATE_CLOUD_ID: o ID da nuvem privada
NODE_COUNT: o número de nós a serem adicionados
CORES_COUNT: o número de núcleos personalizados a serem adicionados

Python

Adicione o novo cluster e especifique a configuração da contagem de núcleos. Por exemplo, o código a seguir cria um novo cluster do tipo de nó standard-72 com uma quantidade configurável de nós e contagem de núcleos.

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)

Remover nós ou excluir um cluster

Ao remover nós de uma nuvem privada, você remove os nós do cluster atual ou exclui o cluster inteiro.

Console

Para remover nós de uma nuvem privada com o console do Google Cloud atualizando o cluster com menos nós, faça o seguinte:

Vá para o console do Google Cloud.
Na navegação principal, clique em Nuvens privadas.
Na página de resumo da nuvem privada, clique em Remover nós.
Selecione o cluster que você quer reduzir ou excluir.
Clique em Remover um nó.
Verifique a capacidade do cluster.
Clique em Enviar para iniciar o processo de remoção de nós.

Para monitorar o progresso, selecione Atividade > Tarefas. Esse processo requer ressincronização na vSAN e pode levar algumas horas, dependendo dos dados.

gcloud

Para remover um nó de uma nuvem privada usando a CLI do Google Cloud, use o comando 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=standard-72,count=NODE_COUNT

Substitua:

CLUSTER_ID: o ID do cluster a ser atualizado nessa nuvem privada
ZONE: a zona da nuvem privada
PRIVATE_CLOUD_ID: o ID da nuvem privada
NODE_COUNT: a nova contagem de nós. Esse novo valor precisa ser um menor que o atual

API

Para remover um nó de uma nuvem privada usando a API VMware Engine, faça uma solicitação 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
    }
  }
}'

Substitua:

CLUSTER_ID: o ID do cluster a ser atualizado nessa nuvem privada
ZONE: a zona da nuvem privada
PRIVATE_CLOUD_ID: o ID da nuvem privada
NODE_COUNT: a nova contagem de nós. Esse novo valor precisa ser um menor que o atual

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)

Excluir um cluster

Para excluir um cluster inteiro, faça o seguinte:

Console

Vá para o console do Google Cloud.
Na navegação principal, clique em Nuvens privadas.
Na página de resumo da nuvem privada, clique em Remover nós.
Selecione o cluster que você quer reduzir ou excluir.
Selecione Excluir todo o cluster.
Verifique a capacidade do cluster.
Clique em Enviar para iniciar o processo de remoção de nós.

gcloud

Para excluir um cluster inteiro usando a CLI do Google Cloud, use o comando gcloud vmware private-clouds clusters delete.

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

Substitua:

CLUSTER_ID: o ID do cluster a ser atualizado nessa nuvem privada
ZONE: a zona da nuvem privada
PRIVATE_CLOUD_ID: o ID da nuvem privada

API

Para excluir um cluster inteiro usando a API VMware Engine, faça uma solicitação 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"

Substitua:

PROJECT_ID: o ID do projeto da nuvem privada
ZONE: a zona da nuvem privada
PRIVATE_CLOUD_ID: o ID da nuvem privada
CLUSTER_ID: o ID do cluster a ser atualizado nessa nuvem privada

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)

Listar nós

Para listar os nós de um determinado cluster de nuvem privada e receber informações sobre vários nós ou um nó específico usando o console do Google Cloud, a CLI do Google Cloud ou a API VMware Engine, faça o seguinte.

Console

Para listar os nós de uma ou várias nuvens privadas usando o console do Google Cloud, siga estas etapas:

Vá para o console do Google Cloud.
Na navegação principal, clique em Nuvens privadas.
Na página de resumo das nuvens privadas, clique no nome da nuvem privada.
Na página de detalhes do cluster, clique na guia Clusters
Na guia clusters, clique no nome do cluster. Todos os nós do cluster são listados na tabela de nós do cluster.

gcloud

Para listar os nós de uma ou várias nuvens privadas usando a CLI do Google Cloud, faça o seguinte:

Liste todos os nós vinculados a um PRIVATE_CLOUD_ID específico da nuvem privada executando o comando 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
```
Substitua:
- PROJECT_ID: o nome do projeto para esta solicitação.
- ZONE: a zona em que está localizada a rede.
- PRIVATE_CLOUD_ID: o ID de rede dessa solicitação.
- CLUSTER_ID: o ID do cluster para esta solicitação.

API

Para listar os nós de uma ou várias nuvens privadas usando a API do VMware Engine, faça o seguinte:

Liste todos os nós vinculados ao PRIVATE_CLOUD_ID específico de uma nuvem privada fazendo uma solicitação GET:
```
GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes"
```
Substitua:
- PROJECT_ID: o nome do projeto para esta solicitação.
- ZONE: a zona em que está localizada a rede.
- PRIVATE_CLOUD_ID: o ID de rede dessa solicitação.
- CLUSTER_ID: o ID do cluster para esta solicitação.

Descrever nós

Para conferir uma descrição de um ou mais nós usando o console do Google Cloud, a CLI do Google Cloud ou a API VMware Engine, faça o seguinte:

Console

Para listar os nós de uma ou várias nuvens privadas usando o console do Google Cloud, siga estas etapas:

Vá para o console do Google Cloud.
Na navegação principal, clique em Nuvens privadas.
Na página de resumo das nuvens privadas, clique no nome da nuvem privada.
Na página de detalhes do cluster, clique na guia Clusters
Na guia clusters, clique no nome do cluster. Os detalhes dos nós estão listados na tabela de nós do cluster.

gcloud

Se você quiser a descrição de um ou mais nós usando a CLI do Google Cloud.

Opcional: encontre o nome do nó executando o comando 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
```
Substitua:
- PROJECT_ID: o nome do projeto para esta solicitação.
- ZONE: a zona em que está localizada a rede.
- PRIVATE_CLOUD_ID: o ID de rede dessa solicitação.
- CLUSTER_ID: o ID do cluster para esta solicitação.
Para conferir a descrição de um nó específico, execute o comando 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
```
Substitua:
- NODE_NAME: o nome do nó retornado do comando anterior. Por exemplo, esxi-1435-f4d250.
- PROJECT_ID: o nome do projeto para esta solicitação.
- ZONE: a zona em que está localizada a rede.
- PRIVATE_CLOUD_ID: o ID da rede dessa solicitação.
- CLUSTER_ID: o ID do cluster para esta solicitação.

API

Se você quiser a descrição de um ou mais nós usando a API VMware Engine.

Opcional: encontre o nome do nó fazendo uma solicitação GET:
```
GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes"
```
Substitua:
- PROJECT_ID: o nome do projeto para esta solicitação.
- ZONE: a zona em que está localizada a rede.
- PRIVATE_CLOUD_ID: o ID da rede dessa solicitação.
- CLUSTER_ID: o ID do cluster para esta solicitação.
Para conseguir a descrição de um nó específico, faça uma solicitação GET:
```
GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes/NODE_NAME"
```
Substitua:
- NODE_NAME: o nome do nó retornado do comando anterior. Por exemplo, esxi-1435-f4d250.
- PROJECT_ID: o nome do projeto para esta solicitação.
- ZONE: a zona em que está localizada a rede.
- PRIVATE_CLOUD_ID: o ID da rede dessa solicitação.
- CLUSTER_ID: o ID do cluster para esta solicitação.

Restrições

O processo de remoção de nós da nuvem privada tem as seguintes restrições:

O cluster do vSphere precisa ter pelo menos três nós. Não é possível remover nós de um cluster do vSphere com três nós.
Se você estiver usando o console do Google Cloud, a CLI gcloud ou a API VMware Engine, só será possível remover um nó por vez com cada solicitação de remoção de nó.
O armazenamento total consumido não pode exceder a capacidade total após a remoção dos nós de um cluster.
Não é possível excluir o primeiro cluster que foi criado durante a criação da nuvem privada.
Se as regras de DRS do vSphere (afinidade e antiafinidade) forem aplicadas a todos os nós de um cluster, os nós não poderão ser removidos do cluster. Exclua as regras e tente novamente a operação de remoção de nó.

Como visualizar sub-redes

Para ver a lista de sub-redes de gerenciamento definidas para sua nuvem privada, selecione a guia Sub-redes. A lista inclui as sub-redes do HCX criadas quando a nuvem privada foi criada.

Como visualizar informações de atividades

Para conferir as informações de atividade da sua nuvem privada, clique em Acessar o visualizador de registros. Para uma lista completa de atividades e ações associadas, consulte Como monitorar a atividade do VMware Engine.

Como visualizar a rede de gerenciamento do vSphere

Para conferir a lista de recursos de gerenciamento e máquinas virtuais do VMware configurados na sua nuvem privada, selecione a guia Rede de gerenciamento de vSphere. As informações incluem a versão do software, o nome de domínio totalmente qualificado (FQDN, na sigla em inglês) e o endereço IP dos recursos.