Criar e executar Testes de conectividade

Aprenda a executar Testes de conectividade seguindo as etapas nesta página.

Para editar ou excluir um ou mais testes, consulte Atualizar ou excluir testes.

Para saber mais sobre os Testes de conectividade, consulte a visão geral.

Antes de começar

Antes de usar o Connectivity Tests, configure os seguintes itens no Google Cloud:

No console Google Cloud , acesse a página do seletor de projetos.

Acessar o seletor de projetos

Selecione ou crie um projeto do Google Cloud .
Verifique se o faturamento foi ativado para o projeto Google Cloud .
Instale a Google Cloud CLI, que faz parte da CLI do Google Cloud. Para instalar a versão mais recente da CLI gcloud, consulte a documentação da CLI gcloud.

Para acessar uma lista de todos os comandos, consulte a referência do comando gcloud.
Ativar a API Network Management. A ativação da API fornece o seguinte:
- Exemplos de chamadas de API que usam a API Network Management.
  
  É possível testar comandos da API Network Management usando o API Explorer. No documento de referência da API Network Management, use a coluna Try this API para explorar os campos da API e executar um teste.
- Exemplo de código que usa o cliente da API Python.
  
  Com o código de exemplo, presumimos que você tenha criado um recurso chamado api para interagir com a API Network Management. Para criar um recurso, use a função build. Veja o exemplo a seguir:
```
from googleapiclient.discovery import build
api = build('networkmanagement', 'v1')
```
  Para mais informações sobre o cliente Python da API, acesse:
  - Documentos da biblioteca de cliente da API Google para Python no GitHub, que inclui instruções de instalação e autenticação.
  - A documentação de referência da API Network Management para o cliente Python da API.
Acesse as permissões necessárias para executar e visualizar testes. Veja mais detalhes em Atribuir acesso.

Executar os Testes de conectividade

Ao executar um teste de conectividade, você fornece entradas de teste como uma tupla de cinco elementos sem a porta de origem.

As seções a seguir mostram como executar um teste para os endpoints de origem e de destino descritos em Casos de uso comuns.

No console do Google Cloud , é possível executar Testes de conectividade usando uma das seguintes opções:

A página Testes de conectividade, disponível no menu Rede > Network Intelligence Center.
A página Detalhes da interface de rede para uma interface de rede de uma instância de máquina virtual (VM) do Compute Engine. Se você usar esta página, precisará usar a interface de rede atual como Origem ou Destino do teste. Nesta página, listamos apenas os testes relevantes para a interface de rede atual.

Cada teste que você cria é executado imediatamente após a criação e é armazenado no recurso Testes de conectividade. O teste existe até você excluí-lo.

Para verificar o status de uma operação de teste enquanto ela é executada, consulte Verificar uma operação de teste em execução. Alguns exemplos de operações de teste são create e rerun.

Ao usar um endereço IP para o terminal de origem ou de destino, pode ser necessário especificar outros campos.

Práticas recomendadas

Quando você testa um endpoint (uma VM ou um endereço IP) localizado em um projeto de serviço de VPC compartilhada, é mais conveniente executar o teste no projeto de serviço. Isso é útil porque você pode selecionar o endereço IP ou a VM no menu suspenso no console do Google Cloud .

No entanto, também é necessário especificar o projeto host antes de especificar a rede de nuvem privada virtual (VPC, na sigla em inglês), porque a rede está no projeto host. Saiba mais em Testar endereços IP em uma rede VPC compartilhada.
Ao executar um teste entre a rede VPC e a rede local ou com peering, é útil executar outro Teste de conectividade usando o endereço IP local como a origem e uma instância de VM ou um endereço IP na rede VPC como destino.

Esse tipo de teste verifica se o Google Cloud está anunciando rotas conforme o esperado para a rede local. No entanto, os Testes de conectividade não verificam se a rede local recebeu e implementou essas rotas.
Leva de 20 a 120 segundos para que os Testes de conectividade recebam uma atualização de configuração e a incorporem à análise. Ao executar um teste imediatamente depois de fazer uma alteração de configuração, você pode não receber os resultados esperados. Espere tempo suficiente entre a alteração de configuração e a execução dos testes.

Esse atraso não se aplica à análise de planos de dados ativos. Portanto, você pode notar uma incompatibilidade temporária entre os resultados mostrados pela análise do plano de dados ativo e pela análise da configuração. Por exemplo, se você adicionar uma regra de firewall, ela poderá ser acessada para a análise do plano de dados ativo. No entanto, talvez seja necessário aguardar algum tempo até que a regra de firewall seja acessível para a análise da configuração.

Realizar testes em uma VM com várias interfaces de rede

Nesta seção, você vai aprender a testar a conectividade de entrada e saída da interface de rede não primária de uma VM.

Console

Se você especificar uma instância de VM com várias interfaces de rede como origem ou destino de um teste, os Testes de conectividade vão solicitar a seleção de uma interface de rede em uma lista.

Também é possível executar um teste na página Detalhes da interface de rede da interface de rede de uma instância de VM do Compute Engine. Se você usar esta página, precisará usar a interface de rede atual como Origem ou Destino do teste.

gcloud e API

É necessário especificar a interface de rede a ser usada no teste de uma das seguintes maneiras:

endereço IP e URI da rede;
endereço IP e URI da VM;
URI da rede e URI da VM.

Fornecer apenas o URI de uma VM com várias interfaces seleciona apenas a interface principal dela.

Listar todos os testes para um projeto

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione um projeto na parte superior da página, no menu suspenso de projetos.
A página Testes de conectividade é atualizada e mostra os testes para esse projeto.

gcloud

Para listar todos os testes de um projeto, insira o seguinte comando gcloud. Este comando mostra os testes no projeto atualmente selecionado.

  gcloud network-management connectivity-tests list

Para listar testes em um projeto específico, especifique o PROJECT_ID.

  gcloud network-management connectivity-tests list --project=PROJECT_ID

API

Para listar todos os testes atuais pertencentes a um projeto, use o método projects.locations.global.connectivityTests.list.

GET https://networkmanagement.googleapis.com/v1/{parent=projects/PROJECT_ID/locations/global}/connectivityTests

Substitua PROJECT_ID pelo ID do projeto que contém os testes que você quer listar.

Python

O código de exemplo a seguir lista todos os testes atuais que pertencem a um projeto. Para mais informações, consulte list na biblioteca de cliente da API do Google para Python.

project_id = "PROJECT_ID"
parent = 'projects/%s/locations/global' % project_id
request = api.projects().locations().global_().connectivityTests().list(parent=parent)

print(json.dumps(request.execute(), indent=4))

Substitua PROJECT_ID pelo ID do projeto que contém os testes que você quer listar.

Testes entre instâncias de VM em uma rede VPC

As etapas a seguir pressupõem que as duas instâncias de VM estejam no mesmo projeto do Google Cloud .

Console

Na página principal dos Testes de conectividade

No console do Google Cloud , acesse a página Testes de Conectividade.

Acessar Testes de conectividade

As etapas restantes aparecem automaticamente no console do Google Cloud .
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione Instância de VM.
2. No menu Instância de VM de origem, selecione a instância específica.
3. No menu Interface de rede de origem, selecione a interface de rede.
  
  Se a instância de VM tiver várias interfaces de rede, selecione uma que identifique exclusivamente o local de origem.
4. Opcional: selecione o Endereço IP de origem na lista. O padrão é o endereço IP da instância de VM de origem.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione Instância de VM.
2. No menu Instância de VM de destino, selecione a instância específica.
3. No menu Interface de rede de destino, selecione a interface de rede.
  
  Se a instância de VM tiver várias interfaces de rede, selecione uma delas para identificar o local de destino de maneira exclusiva.
4. Opcional: selecione o Endereço IP de destino na lista. O padrão é o endereço IP da instância de VM de destino.

Observação: para uma instância de pilha dupla, os endereços IP de origem e de destino precisam ser do mesmo tipo. Por exemplo, não é possível testar a conectividade de uma VM com endereço IPv4 com uma VM com endereço IPv6.

No campo Porta de destino, insira uma porta.
Clique em Criar.

Quando o teste terminar, a página principal dos Testes de conectividade será carregada e mostrará uma lista que contém este e outros testes. Continue para Exibir os resultados do teste.

Na página de detalhes da interface de rede

No console do Google Cloud , acesse a página Instâncias de VM.
Acessar Instâncias de VM
Selecione o projeto que contém a instância em que você quer executar um teste, se ele ainda não estiver selecionado.
Clique na instância que você quer usar para executar um teste.
Em Interfaces de rede, selecione a interface de rede que você quer usar para executar um teste.

Se a instância de VM tiver várias interfaces de rede, selecione uma que identifique exclusivamente o local de destino.
Em Análise de rede, clique em Criar teste de conectividade e faça o seguinte:
1. No campo Nome do teste, insira um nome para o teste.
2. Na lista Protocolo, selecione um protocolo.
3. Em Origem, selecione Interface de rede atual ou Outro.
  
  Se você selecionar Interface de rede atual, faça o seguinte:
  1. No menu Endpoint de destino, selecione Instância de VM.
  2. No menu Instância de VM de destino, selecione a instância.
  3. No menu Interface de rede de destino, selecione a interface de rede.
  4. Opcional: selecione o endereço IP de destino. O padrão é o endereço IP da instância de VM de destino.
  Se você selecionar Outro, faça o seguinte:
  1. No menu Endpoint de origem, selecione Instância de VM.
  2. No menu Instância de VM de origem, selecione a instância.
  3. No menu Interface de rede de origem, selecione a interface de rede.
  4. Opcional: selecione o endereço IP de origem. O padrão é o endereço IP da instância de VM de origem.
4. No campo Porta de destino, insira uma porta de destino para o destino especificado.
5. Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Substitua os valores de exemplo pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-instance=SOURCE_INSTANCE \
    --source-ip-address=SOURCE_IP_ADDRESS \
    --destination-instance=DESTINATION_INSTANCE \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
DESTINATION_INSTANCE: o URI da VM de destino, como projects/myproject/zones/us-east1-b/instances/instance-2.
DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino em que você está realizando o teste. Ele precisa ser um dos endereços IP da instância de VM de destino.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Terraform

É possível usar um recurso Terraform para criar um teste entre duas instâncias de VM em uma rede VPC.

resource "google_network_management_connectivity_test" "instance_test" {
  name = "conn-test-instances"
  source {
    instance = google_compute_instance.source.id
  }

  destination {
    instance = google_compute_instance.destination.id
    port     = "80"
  }

  protocol = "TCP"
}

resource "google_compute_instance" "source" {
  name         = "source-vm"
  machine_type = "e2-medium"

  boot_disk {
    initialize_params {
      image = data.google_compute_image.debian_9.id
    }
  }

  network_interface {
    network = "default"
    access_config {
    }
  }
}

resource "google_compute_instance" "destination" {
  name         = "dest-vm"
  machine_type = "e2-medium"

  boot_disk {
    initialize_params {
      image = data.google_compute_image.debian_9.id
    }
  }

  network_interface {
    network = "default"
    access_config {
    }
  }
}

data "google_compute_image" "debian_9" {
  family  = "debian-11"
  project = "debian-cloud"
}

API

O teste de exemplo a seguir determina se a configuração de rede atual permite que a VM instance1 faça ping na VM instance2.

Use o método projects.locations.global.connectivityTests.create.

 POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
   {
     "source": {
       "instance": "SOURCE_INSTANCE",
       "ipAddress": "SOURCE_IP_ADDRESS",
     },
     "destination": {
       "instance": "DESTINATION_INSTANCE",
       "ipAddress": "DESTINATION_IP_ADDRESS",
     },
     "protocol": "PROTOCOL",
   }'

Substitua:

PROJECT_ID: o ID do projeto da VM de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
DESTINATION_INSTANCE: o URI da VM de destino, como projects/myproject/zones/us-east1-b/instances/instance-2.
DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino em que você está realizando o teste. Ele precisa ser um dos endereços IP da instância de VM de destino.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Python

O código de exemplo a seguir cria um teste entre duas instâncias de VM. Para mais informações, consulte create na biblioteca de cliente da API do Google para Python.

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "ipAddress":
          "SOURCE_IP_ADDRESS",
      "projectId":
          "SOURCE_INSTANCE_PROJECT_ID"
  },
  "destination": {
      "instance":
          "DESTINATION_INSTANCE",
      "ipAddress":
          "DESTINATION_IP_ADDRESS",
      "projectId":
          "DESTINATION_INSTANCE_PROJECT_ID"
  },
  "protocol":
      "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

Substitua:

SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
SOURCE_INSTANCE_PROJECT_ID: o ID do projeto da VM de origem.
DESTINATION_INSTANCE: o URI da VM de destino, como projects/myproject/zones/us-east1-b/instances/instance-2.
DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino em que você está realizando o teste. Ele precisa ser um dos endereços IP da instância de VM de destino.
DESTINATION_INSTANCE_PROJECT_ID: o ID do projeto da VM de destino.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
PROJECT_ID: o ID do projeto em que você está criando o teste.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Teste entre endereços IP privados em uma rede VPC

Este exemplo pressupõe que os dois endereços IP sejam privados no mesmo projeto do Google Cloud e na mesma rede VPC.

Ao fazer testes entre redes VPC com peering, selecione as redes de origem e de destino para cada par.

Console

No console do Google Cloud , acesse a página Testes de Conectividade.

Acessar Testes de conectividade

As etapas restantes aparecem no console do Google Cloud .
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, faça o seguinte:
1. Na lista Endpoint de origem, selecione Endereço IP.
2. No campo Endereço IP de origem, digite o endereço IP de origem.
3. Se a rede VPC do endereço IP de origem estiver no projeto atual, desmarque a caixa de seleção Este é um endereço IP usado no Google Cloud.
  
  Se a rede VPC estiver em outro projeto, no campo Projeto de serviço ou endereço IP de origem, selecione o projeto em que ela está.
  
  Se o endereço IP estiver fora do espaço de endereços RFC 1918, marque a caixa de seleção Confirmo que o endpoint de origem está em um intervalo fora do espaço de endereços RFC 1918. Em seguida, na lista Rede de origem, selecione a rede que contém o endereço IP de origem.
Em Destino, faça o seguinte:
1. Na lista Endpoint de destino, selecione Endereço IP.
2. No campo Endereço IP de destino, digite o endereço de IP.
3. Se a rede VPC do endereço IP de destino estiver no projeto atual, desmarque a caixa de seleção Este é um endereço IP usado no Google Cloud.
  
  Se a rede VPC estiver em outro projeto, no campo Projeto de serviço ou endereço IP de destino, selecione o projeto em que ela está.
  
  Se o endereço IP estiver fora do espaço de endereços RFC 1918, marque a caixa de seleção Confirmo que o endpoint de destino está em um intervalo fora do espaço de endereços RFC 1918. Em seguida, na lista Rede de destino, selecione a rede que contém o endereço IP de destino.
No campo Porta de destino, digite um número de porta válido. O número precisa estar entre 0 e 65.535, incluindo esses valores.
Clique em Criar.

Quando o teste terminar, a página principal dos Testes de conectividade será carregada e mostrará uma lista que contém este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Substitua as variáveis das opções de comando pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-ip-address=SOURCE_IP_ADDRESS \
    --source-network=SOURCE_NETWORK \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --destination-network=DESTINATION_NETWORK \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_NETWORK: o URI da rede VPC em que o endereço IP de origem está, como projects/myproject/global/networks/default.
DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual você está fazendo testes.
DESTINATION_NETWORK: o URI da rede VPC em que o endereço IP de destino está, como projects/myproject/global/networks/network-a.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP. O padrão é a porta 80.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Se a rede for desconhecida ou você não tiver permissão para acessá-la, especifique-a como GCP_NETWORK, em vez de fornecer um URI de rede.

Não é necessário confirmar se o endereço IP está no Google Cloudou se os endpoints de origem e de destino estão fora do espaço de endereços RFC 1918. Esses parâmetros são selecionados automaticamente com base nos endereços IP de origem e de destino.

gcloud network-management connectivity-tests create NAME \
    --source-ip-address=SOURCE_IP_ADDRESS \
    [--source-network-type=GCP_NETWORK] \
    --destination-instance=DESTINATION_INSTANCE  \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_NETWORK_TYPE: o tipo de rede em que a origem está. Neste caso, use o valor GCP_NETWORK.
DESTINATION_INSTANCE: o URI da VM de destino, como projects/myproject/zones/us-east1-b/instances/instance-2.
DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual você está fazendo testes.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP. O padrão é a porta 80.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Ao especificar um endereço IP de origem externo aoGoogle Cloud, especifique um networkType que seja NON_GCP_NETWORK. Substitua os valores no comando a seguir pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-ip-address=SOURCE_IP_ADDRESS \
    --source-network-type=NON_GCP_NETWORK \
    --destination-ip-address= DESTINATION_IP_ADDRESS \
    --destination-network=DESTINATION_NETWORK \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_NETWORK_TYPE: o tipo de rede em que a origem está. Neste caso, use o valor NON_GCP_NETWORK.
DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual você está fazendo testes.
DESTINATION_NETWORK: um URI da rede VPC em que o endereço IP de destino está, como projects/myproject/global/networks/default.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Terraform

É possível usar um recurso Terraform para criar um teste entre dois endereços IP em uma rede VPC.

resource "google_network_management_connectivity_test" "default" {
  name = "conn-test-addr"
  source {
    ip_address   = google_compute_address.source_addr.address
    project_id   = google_compute_address.source_addr.project
    network      = google_compute_network.default.id
    network_type = "GCP_NETWORK"
  }

  destination {
    ip_address = google_compute_address.dest_addr.address
    project_id = google_compute_address.dest_addr.project
    network    = google_compute_network.default.id
    port       = "80"
  }

  protocol = "UDP"
}

resource "google_compute_network" "default" {
  name                    = "connectivity-vpc"
  auto_create_subnetworks = false
}

resource "google_compute_subnetwork" "default" {
  name          = "connectivity-vpc-subnet"
  ip_cidr_range = "10.0.0.0/8"
  region        = "us-central1"
  network       = google_compute_network.default.id
}

resource "google_compute_firewall" "default" {
  name    = "allow-incoming-all"
  network = google_compute_network.default.name

  allow {
    protocol = "all"
  }

  source_ranges = ["0.0.0.0/0"]
}

resource "google_compute_address" "source_addr" {
  name         = "src-addr"
  subnetwork   = google_compute_subnetwork.default.id
  address_type = "INTERNAL"
  address      = "10.0.0.42"
  region       = "us-central1"
}

resource "google_compute_address" "dest_addr" {
  name         = "dest-addr"
  subnetwork   = google_compute_subnetwork.default.id
  address_type = "INTERNAL"
  address      = "10.0.0.43"
  region       = "us-central1"
}

resource "google_compute_instance" "source" {
  name         = "source-vm1"
  machine_type = "e2-medium"
  zone         = "us-central1-a"

  boot_disk {
    initialize_params {
      image = data.google_compute_image.default.id
    }
  }

  network_interface {
    network    = google_compute_network.default.id
    subnetwork = google_compute_subnetwork.default.id
    network_ip = "10.0.0.42"
    access_config {
    }
  }
}

resource "google_compute_instance" "destination" {
  name         = "dest-vm1"
  machine_type = "e2-medium"
  zone         = "us-central1-a"

  boot_disk {
    initialize_params {
      image = data.google_compute_image.default.id
    }
  }

  network_interface {
    network    = google_compute_network.default.id
    subnetwork = google_compute_subnetwork.default.id
    network_ip = "10.0.0.43"
    access_config {
    }
  }
}

data "google_compute_image" "default" {
  family  = "debian-11"
  project = "debian-cloud"
}

API

Este exemplo testa a capacidade de fazer ping do endereço IP de origem para o de destino.

Use o método projects.locations.global.connectivityTests.create.

  POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "network": "SOURCE_NETWORK"
    },
    "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "network": "DESTINATION_NETWORK",
      "port": "DESTINATION_PORT",
    },
      "protocol": "PROTOCOL".
  }'

Substitua:

PROJECT_ID: o ID do projeto da VM de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_NETWORK: o URI da rede VPC em que o endereço IP de origem está, como projects/myproject/global/networks/default.
DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual você está fazendo testes.
DESTINATION_NETWORK: um URI da rede VPC em que o endereço IP de destino está, como projects/myproject/global/networks/network-a.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Se a rede VPC for desconhecida ou você não tiver permissão para acessá-la, especifique-a como GCP_NETWORK, em vez de fornecer um URI de rede.

  POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?connectivityTestId=TEST_ID'
  {
    "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "networkType": "GCP_NETWORK"
    },
    "destination": {
      "instance": "DESTINATION_INSTANCE",
      "ipAddress": "DESTINATION_IP_ADDRESS"
    },
    "protocol": "PROTOCOL"
  }'

Substitua:

PROJECT_ID: o ID do projeto da VM de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_NETWORK_TYPE: o tipo de rede em que a origem está. Neste caso, use o valor GCP_NETWORK.
DESTINATION_INSTANCE: o URI da VM de destino, como projects/myproject/zones/us-east1-b/instances/instance-2.
DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual você está fazendo testes.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Ao especificar um endereço IP de origem externo aoGoogle Cloud, especifique um networkType que seja NON_GCP_NETWORK. Substitua os valores no comando a seguir pelos valores da sua rede do Google Cloud .

  POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "networkType": "NON_GCP_NETWORK",

    },
    "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "network": "DESTINATION_NETWORK",
      "port": "DESTINATION_PORT",
    },
    "protocol": "PROTOCOL",
  }'

Python

O código de exemplo a seguir cria um teste entre dois endereços IP. Para mais informações, consulte create na biblioteca de cliente da API do Google para Python.

test_input = {
  "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "projectId": "SOURCE_IP_PROJECT_ID"
  },
  "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "port": "DESTINATION_PORT",
      "projectId": "DESTINATION_IP_PROJECT_ID"
  },
  "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

Substitua:

SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_IP_PROJECT_ID: o ID do projeto do endereço IP de origem.
DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual você está fazendo testes.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
DESTINATION_IP_PROJECT_ID: o ID do projeto do endereço IP de destino.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
PROJECT_ID: o ID do projeto em que você está criando o teste.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Se a rede VPC for desconhecida ou você não tiver permissão para acessá-la, especifique-a como GCP_NETWORK, em vez de fornecer um URI de rede.

O exemplo abaixo cria um teste entre dois endereços IP:

test_input = {
    "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "networkType": "GCP_NETWORK"
    },
    "destination": {
        "ipAddress": "DESTINATION_IP_ADDRESS",
        "port": "DESTINATION_PORT",
        "projectId": "DESTINATION_IP_PROJECT_ID"
    },
    "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
  parent="projects/PROJECT_ID/locations/global",
  testId="TEST_ID",
  body=test_input)

print(json.dumps(request.execute(), indent=4))

Substitua:

SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_NETWORK_TYPE: o tipo de rede em que a origem está. Neste caso, use o valor GCP_NETWORK.
DESTINATION_IP_ADDRESS: o endereço IP da VM de destino.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
DESTINATION_IP_PROJECT_ID: o ID do projeto do endereço IP de destino.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
PROJECT_ID: o ID do projeto em que você está criando o teste.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Ao especificar um endereço IP de origem externo aoGoogle Cloud, especifique um networkType que seja NON_GCP_NETWORK.

Testar endereços IP em uma rede VPC compartilhada

Quando você tem uma rede VPC compartilhada, é possível criar e executar um teste no projeto host ou no projeto de serviço.

O exemplo a seguir mostra os dois casos e usa um endereço IP de destino alocado no projeto de serviço. Os valores de campo no console do Google Cloud são ligeiramente diferentes para cada caso. No entanto, as opções de comando para a CLI do Google Cloud e as chamadas de API são as mesmas.

Console: no host

No console do Google Cloud , no projeto host, acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione Endereço IP.
2. Digite o endereço IP de origem.
3. Marque a caixa de seleção Este é um endereço IP usado no Google Cloud.
4. Se este for um endereço IP interno não acessível pela Internet, selecione a rede VPC em que ele está.
5. Se o endereço IP privado estiver fora do espaço de endereços RFC 1918, marque a caixa de seleção Confirmo que o endpoint de origem está em um intervalo fora do espaço de endereços RFC 1918 e selecione a rede de destino em que ele está.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione Endereço IP.
2. Digite o endereço IP de destino.
3. Marque a caixa de seleção Este é um endereço IP usado no Google Cloud.
4. Se este for um endereço IP interno não acessível pela Internet, selecione a rede VPC em que ele está.
5. Se o endereço IP privado estiver fora do espaço de endereços RFC 1918, marque a caixa de seleção Confirmo que o endpoint de origem está em um intervalo fora do espaço de endereços RFC 1918 e selecione a rede de destino em que ele está.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

Console: no serviço

No console do Google Cloud , no projeto de serviço, acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione Endereço IP.
2. Digite o Endereço IP de origem.
3. Marque a caixa de seleção Este é um endereço IP usado no Google Cloud.
4. Se este for um endereço IP interno não acessível pela Internet, selecione a rede VPC em que ele está.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione Endereço IP.
2. Digite o Endereço IP de destino.
3. Marque a caixa de seleção Este é um endereço IP usado no Google Cloud.
4. Especifique o Projeto de serviço ou o endereço IP de destino em que o endereço IP está.
5. Se o endereço IP privado estiver fora do espaço de endereços RFC 1918, marque a caixa de seleção Confirmo que o endpoint de origem está em um intervalo fora do espaço de endereços RFC 1918 e selecione a rede de destino em que ele está.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Digite o comando a seguir para testar entre dois endereços IP privados em um host e em um projeto de serviço em que o endereço IP de destino esteja localizado no projeto de serviço. Substitua variáveis para as opções de comando pelos valores da sua rede VPC.

Como o endereço IP de destino está no projeto de serviço, especifique o projeto de serviço e o URI da rede do projeto host. Nesse caso, default representa a rede VPC padrão do host-project.

gcloud network-management connectivity-tests create NAME \
    --source-ip-address=SOURCE_IP_ADDRESS \
    --source-project=SOURCE_PROJECT \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --destination-network=DESTINATION_NETWORK \
    --destination-project=DESTINATION_PROJECT \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_PROJECT: o ID do projeto do endpoint de origem.
DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual você está realizando testes no projeto de serviço.
DESTINATION_NETWORK: um URI da rede VPC do projeto host, como projects/host-project/global/networks/default.
DESTINATION_PROJECT: o ID do projeto do endpoint de destino. Por exemplo, um projeto chamado service-project que representa o projeto de serviço usado para essa rede VPC compartilhada.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

API

Use o método projects.locations.global.connectivityTests.create.

  POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
    {
      "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "projectId": "SOURCE_PROJECT",
      },
      "destination": {
        "ipAddress": "DESTINATION_IP_ADDRESS",
        "projectId": "DESTINATION_PROJECT",
        "network": "DESTINATION_NETWORK",
        "port": "DESTINATION_PORT",
      },
      "protocol": "PROTOCOL",
    }'

Substitua:

PROJECT_ID: o ID do projeto da VM de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_PROJECT: o ID do projeto do endpoint de origem.
DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual você está realizando testes no projeto de serviço.
DESTINATION_PROJECT: o ID do projeto do endpoint de destino. Por exemplo, um projeto chamado service-project que representa o projeto de serviço usado para essa rede VPC compartilhada.
DESTINATION_NETWORK: um URI da rede VPC do projeto host, como projects/host-project/global/networks/default.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Python

O código de exemplo a seguir cria um teste entre dois endereços IP. Para mais informações, consulte create na biblioteca de cliente da API do Google para Python.

test_input = {
  "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "projectId": "SOURCE_IP_PROJECT_ID"
  },
  "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "projectId": "DESTINATION_IP_PROJECT_ID",
      "network": "DESTINATION_NETWORK",
      "port": "DESTINATION_PORT",
  },
  "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

Substitua:

SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_IP_PROJECT_ID: o ID do projeto do endpoint de origem.
DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual você está realizando testes no projeto de serviço.
DESTINATION_IP_PROJECT_ID: o ID do projeto do endpoint de destino. Por exemplo, um projeto chamado service-project que representa o projeto de serviço usado para essa rede VPC compartilhada.
DESTINATION_NETWORK: um URI da rede VPC do projeto host, como projects/host-project/global/networks/default.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
PROJECT_ID: o ID do projeto em que você está criando o teste.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Testar a conectividade de uma VM com um serviço gerenciado pelo Google

Nesta seção, você vai aprender a testar a conectividade de uma VM na rede VPC com um serviço executado em uma rede VPC do Google. Por exemplo, siga as etapas nesta seção para testar a conectividade com uma instância do Cloud SQL ou com o plano de controle de um cluster do GKE. Também é possível executar um teste usando o endpoint de um serviço gerenciado pelo Google como origem e um endpoint na rede VPC como destino.

Por padrão, os Testes de conectividade tentam executar um teste usando o endereço IP privado do endpoint do serviço gerenciado pelo Google. Se o endpoint não tiver um endereço IP privado, os Testes de conectividade vão usar o endereço IP público. Os Testes de conectividade analisam se o pacote consegue acessar o endpoint, o que inclui analisar a configuração na rede VPC do Google. Se forem detectados problemas de configuração no seu projeto, a análise será interrompida antes de analisar a configuração de rede do Google.

Para testar a partir de uma VM em um serviço gerenciado pelo Google, consulte as instruções a seguir.

Console

Na página principal dos Testes de conectividade

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione Instância de VM.
2. No menu Instância de VM de origem, selecione a instância específica.
3. No menu Interface de rede de origem, selecione a interface de rede.
  
  Se a instância de VM tiver várias interfaces de rede, selecione uma que identifique exclusivamente o local de origem.
4. Opcional: selecione o Endereço IP de origem na lista. O padrão é o endereço IP da instância de VM de origem.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione um tipo de recurso de serviço gerenciado pelo Google, como o plano de controle do cluster do GKE.
2. No menu Plano de controle do cluster do GKE de destino, selecione o cluster em que você quer testar a conectividade com o plano de controle do GKE.
3. Opcional: selecione o endpoint do plano de controle do cluster do GKE de destino na lista. O padrão é o endpoint baseado em IP do cluster do GKE.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

Na página de detalhes da interface de rede

No console do Google Cloud , acesse a página Instâncias de VM.
Acessar Instâncias de VM
Selecione o projeto que contém a instância em que você quer executar um teste, se ele ainda não estiver selecionado.
Clique na instância que você quer usar para executar um teste.
Em Interfaces de rede, selecione a interface de rede que você quer usar para executar um teste.
Em Análise de rede, clique em Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, selecione Interface de rede atual.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione um tipo de recurso de serviço gerenciado pelo Google, como o plano de controle do cluster do GKE.
2. No menu Plano de controle do cluster do GKE de destino, selecione o cluster em que você quer testar a conectividade com o plano de controle do GKE.
3. Opcional: selecione o endpoint do plano de controle do cluster do GKE de destino na lista. O padrão é o endpoint baseado em IP do cluster do GKE.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
1. Clique em Criar.
2. Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Substitua as variáveis das opções de comando de acordo com a seguinte orientação:

gcloud network-management connectivity-tests create NAME \
    --source-instance=SOURCE_INSTANCE \
    --source-ip-address=SOURCE_IP_ADDRESS \
      DESTINATION_RESOURCE_FLAG=DESTINATION_ENDPOINT \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
DESTINATION_RESOURCE_FLAG: a flag que especifica o tipo de recurso de serviço gerenciado pelo Google.

Para as opções disponíveis, consulte:
- --destination-gke-master-cluster
- --destination-cloud-sql-instance
Para mais informações, consulte a referência de gcloud network-management connectivity-tests create.
DESTINATION_ENDPOINT: o URI do endpoint de destino. Por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1 para a flag --destination-gke-master-cluster.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

API

Use o método projects.locations.global.connectivityTests.create.

 POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
   {
     "source": {
       "instance": "SOURCE_INSTANCE",
       "ipAddress": "SOURCE_IP_ADDRESS",
     },
     "destination": {
       "DESTINATION_RESOURCE_FIELD": "DESTINATION_ENDPOINT",
       "port": DESTINATION_PORT
     },
     "protocol": "PROTOCOL",
   }'

Substitua:

PROJECT_ID: o ID do projeto da VM de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
DESTINATION_RESOURCE_FIELD: o campo que especifica o tipo de recurso de serviço gerenciado pelo Google.

Para as opções disponíveis, consulte:
- gkeMasterCluster
- cloudSqlInstance
- redisInstance
- redisCluster
Para mais informações, consulte a referência do endpoint.
DESTINATION_ENDPOINT: o URI do endpoint de destino. Por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1 para o campo gkeMasterCluster.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Python

O código de exemplo a seguir cria um teste entre uma instância de VM e um endpoint de serviço gerenciado pelo Google. Para mais informações, consulte create na biblioteca de cliente da API do Google para Python.

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "ipAddress":
          "SOURCE_IP_ADDRESS",
      "projectId":
          "SOURCE_INSTANCE_PROJECT_ID"
  },
  "destination": {
      "DESTINATION_RESOURCE_FIELD":
          "DESTINATION_ENDPOINT",
      "port":
          "DESTINATION_PORT"
  },
  "protocol":
      "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

Substitua:

SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
SOURCE_INSTANCE_PROJECT_ID: o ID do projeto da VM de origem.
DESTINATION_RESOURCE_FIELD: o campo que especifica o tipo de recurso de serviço gerenciado pelo Google.

Para as opções disponíveis, consulte:
- gkeMasterCluster
- cloudSqlInstance
- redisInstance
- redisCluster
Para mais informações, consulte a referência do endpoint.
DESTINATION_ENDPOINT: o URI do endpoint de destino. Por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1 para o campo gkeMasterCluster.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
PROJECT_ID: o ID do projeto em que você está criando o teste.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Testar a conectividade de uma VM com endpoints do Private Service Connect

Nesta seção, descrevemos como testar a conectividade de uma VM com um endpoint do Private Service Connect.

Por exemplo, é possível seguir as etapas desta seção para testar se um pacote pode ser entregue a um serviço publicado que usa o Private Service Connect. Os Testes de conectividade analisam se um pacote pode acessar o endpoint, o que inclui a análise dos endpoints conectados, dos serviços publicados e da conexão de proxy. A análise termina antecipadamente quando a conexão com um serviço publicado que usa o Private Service Connect não é aceita.

Você pode testar a conectividade com:

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione Instância de VM.
2. No menu Instância de VM de origem, selecione a instância específica.
3. No menu Interface de rede de origem, selecione a interface de rede.
  
  Se a instância de VM tiver várias interfaces de rede, selecione uma que identifique exclusivamente o local de origem.
4. Opcional: selecione o Endereço IP de origem na lista. O padrão é o endereço IP da instância de VM de origem.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione Endpoint do PSC.
2. No menu Endpoint do PSC de destino, selecione o endpoint do PSC.
  
  Se o endpoint de destino estiver em um projeto diferente do atual, selecione O endpoint está em um projeto diferente de PROJECT_NAME. Em seguida, no campo Projeto de endpoint de destino, selecione o projeto em que o endpoint está.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-instance=SOURCE_INSTANCE \
    --source-ip-address=SOURCE_IP_ADDRESS \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --destination-network=DESTINATION_NETWORK \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
DESTINATION_IP_ADDRESS: o endereço IP do endpoint ou back-end que você quer testar.
DESTINATION_NETWORK: um URI da rede VPC em que o endereço IP de destino está, como projects/myproject/global/networks/default.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Se o endpoint ou back-end for usado para acessar serviços publicados, será necessário especificar a DESTINATION_NETWORK porque ele tem um endereço IP interno.

API

O exemplo de teste a seguir determina se a configuração de rede atual permite que a VM instance1 faça um ping no endereço IP do endpoint do Private Service Connect.

Use o método projects.locations.global.connectivityTests.create.

 POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
   {
     "source": {
       "instance": "SOURCE_INSTANCE",
       "ipAddress": "SOURCE_IP_ADDRESS",
     },
    "destination": {
      "forwardingRule": "DESTINATION_FORWARDING_RULE",
      "port": "DESTINATION_PORT",
     },
     "protocol": "PROTOCOL",
   }'

Substitua:

PROJECT_ID: o ID do projeto da VM de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
DESTINATION_IP_ADDRESS: o endereço IP do endpoint ou back-end que você quer testar.
DESTINATION_NETWORK: um URI da rede VPC em que o endereço IP de destino está, como projects/myproject/global/networks/default.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Se o endpoint ou back-end for usado para acessar serviços publicados, será necessário especificar a DESTINATION_NETWORK porque ele tem um endereço IP interno.

Python

O código de exemplo a seguir cria um teste entre uma instância de VM e um endpoint do Private Service Connect. Para mais informações, consulte create na biblioteca de cliente da API do Google para Python.

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "ipAddress":
          "SOURCE_IP_ADDRESS",
      "projectId":
          "SOURCE_INSTANCE_PROJECT_ID"
  },
  "destination": {
      "forwardingRule": "DESTINATION_FORWARDING_RULE",
      "port": "DESTINATION_PORT",
  },
  "protocol":
      "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

Substitua:

SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
SOURCE_INSTANCE_PROJECT_ID: o ID do projeto da VM de origem.
DESTINATION_IP_ADDRESS: o endereço IP do endpoint ou back-end que você quer testar.
DESTINATION_NETWORK: um URI da rede VPC em que o endereço IP de destino está, como projects/myproject/global/networks/default.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
PROJECT_ID: o ID do projeto em que você está criando o teste.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Se o endpoint ou back-end for usado para acessar serviços publicados, será necessário especificar a DESTINATION_NETWORK porque ele tem um endereço IP interno.

Testar a conectividade de uma versão do ambiente padrão do App Engine com um destino

Nesta seção, descrevemos como testar a conectividade de uma versão do ambiente padrão do App Engine com uma instância de VM, um endereço IP ou um serviço gerenciado pelo Google.

O app do ambiente padrão do App Engine é composto por um único recurso que inclui pelo menos um serviço. Em cada serviço, são implantadas versões desse serviço. É possível testar a acessibilidade de uma versão de um serviço do ambiente padrão do App Engine com uma instância de VM, um endereço IP ou um serviço gerenciado pelo Google.

Para conferir uma análise detalhada da configuração, configure o serviço para usar um conector de acesso VPC sem servidor. O resultado do teste de conectividade pode ser diferente para cada versão do serviço. Só é possível testar a acessibilidade dos pacotes de teste que usam o protocolo UDP ou TCP.

Testar a conectividade de uma versão de um serviço do ambiente padrão do App Engine com uma instância de VM

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
Insira um nome para o teste.
Selecione um protocolo.
No menu Endpoint de origem, selecione App Engine.
1. No menu Serviço do App Engine, selecione o serviço específico do ambiente padrão do App Engine em que você quer testar a conectividade. Por exemplo, selecione helloworld-service.
  1. Se o endpoint de origem estiver em um projeto diferente do atual, marque a caixa de seleção O endpoint está em um projeto diferente de PROJECT_NAME.
  2. Selecione um projeto em que o endpoint existe.
2. No menu Versão do App Engine, selecione uma versão do serviço do ambiente padrão do App Engine em que você quer testar a conectividade.
Em Destino, selecione uma Instância de VM de destino na lista.

Se a instância de VM tiver várias interfaces de rede, selecione uma que identifique exclusivamente o local de destino.
Opcional: selecione o Endereço IP de destino na lista. O padrão é o endereço IP da instância de VM de destino.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-app-engine-version=APP_ENGINE_VERSION \
    --destination-instance=DESTINATION_INSTANCE \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
APP_ENGINE_VERSION: o URI da versão do ambiente padrão do App Engine de origem. Por exemplo, apps/myproject/services/service-name/versions/version-name.
DESTINATION_INSTANCE: o URI da VM de destino, como projects/myproject/zones/us-east1-b/instances/instance-2.
DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino em que você está realizando o teste. Ele precisa ser um dos endereços IP da instância de VM de destino.
PROTOCOL: os protocolos de rede aceitos pelos conectores de acesso VPC sem servidor, ou seja, TCP ou UDP.

API

Use o método projects.locations.global.connectivityTests.create.

  POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "appEngineVersion": {
        "uri": "APP_ENGINE_VERSION",
        },
    },
    "destination": {
      "instance": "DESTINATION_INSTANCE",
      "ipAddress": "DESTINATION_IP_ADDRESS",
    },
    "protocol": "PROTOCOL",
  }'

Substitua:

PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
APP_ENGINE_VERSION: o URI da versão do ambiente padrão do App Engine de origem. Por exemplo, apps/myproject/services/service-name/versions/version-name.
DESTINATION_INSTANCE: o URI da VM de destino, como projects/myproject/zones/us-east1-b/instances/instance-2.
DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino em que você está realizando o teste. Ele precisa ser um dos endereços IP da instância de VM de destino.
PROTOCOL: os protocolos de rede aceitos pelos conectores de acesso VPC sem servidor, ou seja, TCP ou UDP.

Testar a conectividade de uma versão de um serviço do ambiente padrão do App Engine com um endereço IP

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
Insira um nome para o teste.
Selecione um protocolo.
No menu Endpoint de origem, selecione um App Engine.
1. No menu Serviço do App Engine, selecione o serviço específico do ambiente padrão do App Engine em que você quer testar a conectividade. Por exemplo, selecione helloworld-service.
  1. Se o endpoint de origem estiver em um projeto diferente do atual, marque O endpoint está em um projeto diferente de PROJECT_NAME.
  2. Selecione um projeto em que o endpoint existe.
2. No menu Versão do App Engine, selecione uma versão do serviço do ambiente padrão do App Engine em que você quer testar a conectividade.
Em Destino, selecione Endereço IP e insira um endereço IP.
Insira uma porta de destino.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-app-engine-version=APP_ENGINE_VERSION \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
APP_ENGINE_VERSION: o URI da versão do ambiente padrão do App Engine de origem. Por exemplo, apps/myproject/services/service-name/versions/version-name.
DESTINATION_IP_ADDRESS: o endereço IP de destino externo em que você está realizando testes.
PROTOCOL: os protocolos de rede aceitos pelos conectores de acesso VPC sem servidor, ou seja, TCP ou UDP.

API

Use o método projects.locations.global.connectivityTests.create.

  POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "appEngineVersion": {
        "uri": "APP_ENGINE_VERSION",
        },
    },
    "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
    },
    "protocol": "PROTOCOL",
  }'

Substitua:

PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
APP_ENGINE_VERSION: o URI da versão do ambiente padrão do App Engine de origem. Por exemplo, apps/myproject/services/service-name/versions/version-name.
DESTINATION_IP_ADDRESS: o endereço IP de destino externo em que você está realizando testes.
PROTOCOL: os protocolos de rede aceitos pelos conectores de acesso VPC sem servidor, ou seja, TCP ou UDP.

Testar a conectividade de uma versão de um serviço do ambiente padrão do App Engine com um serviço gerenciado pelo Google

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
Insira um nome para o teste.
Selecione um protocolo.
No menu Endpoint de origem, selecione um App Engine.
1. No menu Serviço do App Engine, selecione o serviço específico do ambiente padrão do App Engine em que você quer testar a conectividade. Por exemplo, selecione helloworld-service.
  1. Se o endpoint de origem estiver em um projeto diferente do atual, marque O endpoint está em um projeto diferente de PROJECT_NAME.
  2. Selecione um projeto em que o endpoint existe.
2. No menu Versão do App Engine, selecione uma versão do serviço do ambiente padrão do App Engine em que você quer testar a conectividade.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione um tipo de recurso de serviço gerenciado pelo Google, como o plano de controle do cluster do GKE.
2. No menu Plano de controle do cluster do GKE de destino, selecione o cluster em que você quer testar a conectividade com o plano de controle do GKE.
3. Opcional: selecione o endpoint do plano de controle do cluster do GKE de destino na lista. O padrão é o endpoint baseado em IP do cluster do GKE.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-app-engine-version=APP_ENGINE_VERSION \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
      DESTINATION_RESOURCE_FLAG=DESTINATION_ENDPOINT \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
APP_ENGINE_VERSION: o URI da versão do ambiente padrão do App Engine de origem. Por exemplo, apps/myproject/services/servicename/versions/version-number.
DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual você está fazendo testes.
DESTINATION_RESOURCE_FLAG: a flag que especifica o tipo de recurso de serviço gerenciado pelo Google.

Para as opções disponíveis, consulte:
- --destination-gke-master-cluster
- --destination-cloud-sql-instance
Para mais informações, consulte a referência de gcloud network-management connectivity-tests create.
DESTINATION_ENDPOINT: o URI do endpoint de destino. Por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1 para a flag --destination-gke-master-cluster.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP. O padrão é a porta 80.
PROTOCOL: os protocolos de rede aceitos pelos conectores de acesso VPC sem servidor, ou seja, TCP ou UDP.

API

Use o método projects.locations.global.connectivityTests.create.

  POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "appEngineVersion": {
        "uri": "APP_ENGINE_VERSION",
        },
    },
    "destination": {
      "DESTINATION_RESOURCE_FIELD": "DESTINATION_ENDPOINT",
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "port": DESTINATION_PORT,
    },
    "protocol": "PROTOCOL",
  }'

Substitua:

PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
APP_ENGINE_VERSION: o URI da versão do ambiente padrão do App Engine de origem. Por exemplo, apps/myproject/services/servicename/versions/version-number.
DESTINATION_RESOURCE_FIELD: o campo que especifica o tipo de recurso de serviço gerenciado pelo Google.

Para as opções disponíveis, consulte:
- gkeMasterCluster
- cloudSqlInstance
- redisInstance
- redisCluster
Para mais informações, consulte a referência do endpoint.
DESTINATION_ENDPOINT: o URI do endpoint de destino. Por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1 para o campo gkeMasterCluster.
DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual você está fazendo testes.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP. O padrão é a porta 80.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Testar a conectividade de uma função do Cloud Run com um destino

Nesta seção, descrevemos como testar a conectividade de uma função do Cloud Run implantada em uma região específica do Google Cloud com uma instância de VM, um endereço IP ou um serviço gerenciado pelo Google. Por exemplo, é possível seguir as etapas desta seção para testar a conectividade de uma função do Cloud Run implantada em us-central1 como a origem com um endpoint na rede VPC como o destino.

Para conferir uma análise detalhada da configuração, verifique se a função do Cloud Run está ativa e se você configurou um conector de acesso VPC sem servidor para ela.

As configurações de saída do Cloud Run functions controlam o roteamento de solicitações HTTP de saída de uma função do Cloud Run e os tipos de tráfego roteados pelo conector para a rede VPC. Para mais informações, consulte Configurações de saída do Cloud Run functions.

Testar a conectividade de uma função do Cloud Run com uma instância de VM

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione 1ª geração da função do Cloud.
2. No menu Função do Cloud, selecione a função do Cloud Run específica em que você quer testar a conectividade. Por exemplo, selecione function-1.
3. No menu de localização Função do Cloud, selecione a região do Google Cloud em que você implantou a função do Cloud Run. É possível implantar o Cloud Run functions em várias regiões com configurações diferentes, mas com o mesmo nome.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione Instância de VM.
2. No menu Instância de VM de destino, selecione uma instância de VM.
3. No menu Interface de rede de destino, selecione a interface de rede.
  
  Se a instância de VM tiver várias interfaces de rede, selecione uma que identifique exclusivamente o local de destino.
4. Opcional: selecione o Endereço IP de destino na lista. O padrão é o endereço IP da instância de VM de destino.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-cloud-function=SOURCE_CLOUD_FUNCTION \
    --destination-instance=DESTINATION_INSTANCE \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_CLOUD_FUNCTION: o URI da função do Cloud Run, como projects/myproject/locations/us-central1/functions/function-1.
DESTINATION_INSTANCE: o URI da VM de destino, como projects/myproject/zones/us-east1-b/instances/instance-2.
DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino em que você está realizando o teste. Ele precisa ser um dos endereços IP da instância de VM de destino.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

API

Use o método projects.locations.global.connectivityTests.create.

POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
{
  "source": {
    "cloudFunction": {
      "uri": "SOURCE_CLOUD_FUNCTION",
      },
  },
  "destination": {
    "instance": "DESTINATION_INSTANCE",
    "ipAddress": "DESTINATION_IP_ADDRESS",
  },
  "protocol": "PROTOCOL",
}'

Substitua:

PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
SOURCE_CLOUD_FUNCTION: o URI da função do Cloud Run, como projects/myproject/locations/us-central1/functions/function-1.
DESTINATION_INSTANCE: o URI da VM de destino, como projects/myproject/zones/us-east1-b/instances/instance-2.
DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino em que você está realizando o teste. Ele precisa ser um dos endereços IP da instância de VM de destino.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Testar a conectividade de uma função do Cloud Run com um endereço IP

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione 1ª geração da função do Cloud.
2. No menu Função do Cloud, selecione a função do Cloud Run específica em que você quer testar a conectividade. Por exemplo, selecione function-1.
3. No menu de localização Função do Cloud, selecione a região do Google Cloud em que você implantou a função do Cloud Run. É possível implantar o Cloud Run functions em várias regiões com configurações diferentes, mas com o mesmo nome.
Em Destino, selecione Endereço IP e insira um endereço IP.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para a seção Exibir resultados do teste mais adiante nesta página.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-cloud-function=SOURCE_CLOUD_FUNCTION \
    --destination-ip-address==DESTINATION_IP_ADDRESS \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_CLOUD_FUNCTION: o URI da função do Cloud Run, como projects/myproject/locations/us-central1/functions/function-1.
DESTINATION_IP_ADDRESS: o endereço IP de destino em que você está realizando testes.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

API

Use o método projects.locations.global.connectivityTests.create.

POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
{
  "source": {
    "cloudFunction": {
      "uri": "SOURCE_CLOUD_FUNCTION",
    },
  },
  "destination": {
    "ipAddress": "DESTINATION_IP_ADDRESS",
  },
  "protocol": "PROTOCOL",
}'

Substitua:

PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
SOURCE_CLOUD_FUNCTION: o URI da função do Cloud Run, como projects/myproject/locations/us-central1/functions/function-1.
DESTINATION_IP_ADDRESS: o endereço IP de destino em que você está realizando testes.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Testar a conectividade de uma função do Cloud Run com um serviço gerenciado pelo Google

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione 1ª geração da função do Cloud.
2. No menu Função do Cloud, selecione a função do Cloud Run específica em que você quer testar a conectividade. Por exemplo, selecione function-1.
3. No menu de Localização da função do Cloud, selecione a região do Google Cloud em que você implantou a função do Cloud Run. É possível implantar o Cloud Run functions em várias regiões com configurações diferentes, mas com o mesmo nome.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione um tipo de recurso de serviço gerenciado pelo Google, como Instância do Cloud SQL.
2. No menu Instância do Cloud SQL de destino, selecione a instância do Cloud SQL em que você quer testar a conectividade.
3. Opcional: selecione o Endereço IP da instância do Cloud SQL de destino na lista. O padrão é o endereço IP da função do Cloud Run de origem.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para a seção Exibir resultados do teste mais adiante nesta página.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-cloud-function=SOURCE_CLOUD_FUNCTION \
      DESTINATION_RESOURCE_FLAG=DESTINATION_ENDPOINT \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_CLOUD_FUNCTION: o URI da função do Cloud Run, como projects/myproject/locations/us-central1/functions/function-1.
DESTINATION_RESOURCE_FLAG: a flag que especifica o tipo de recurso de serviço gerenciado pelo Google.

Para as opções disponíveis, consulte:
- --destination-gke-master-cluster
- --destination-cloud-sql-instance
Para mais informações, consulte a referência de gcloud network-management connectivity-tests create.
DESTINATION_ENDPOINT: o URI do endpoint de destino. Por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1 para a flag --destination-gke-master-cluster.
DESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual você está fazendo testes.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP. O padrão é a porta 80.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Testar a conectividade de uma revisão do Cloud Run com um destino

Nesta seção, descrevemos como testar a conectividade de uma revisão do Cloud Run com uma instância de VM, um endereço IP ou um serviço gerenciado pelo Google.

É possível implantar vários serviços do Cloud Run em um único projeto. Cada serviço do Cloud Run tem um endpoint HTTPS em um subdomínio exclusivo do domínio *.run.app. Cada implantação do serviço do Cloud Run cria uma revisão imutável. É possível testar a acessibilidade de uma revisão com uma instância de VM, um endereço IP ou um serviço gerenciado pelo Google. Para conferir uma análise detalhada da configuração, configure um conector de acesso VPC sem servidor para a revisão. Os resultados dos testes de conectividade podem ser diferentes para cada revisão.

Por exemplo, um serviço do Cloud Run chamadocloud_run_test tem uma revisão first-revision configurada para usar um conector de acesso VPC sem servidor e outra revisão second-revision que não está configurada para usá-lo. O resultado geral da acessibilidade pode ser acessado pela first-revision, mas não pela second-revision.

Ao criar um teste de conectividade, é possível selecionar uma revisão em uma lista de revisões de um serviço do Cloud Run.

Testar a conectividade de uma revisão de um serviço do Cloud Run com uma instância de VM

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
Insira um nome para o teste.
Selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione Cloud Run.
2. No menu Serviço do Cloud Run, selecione o serviço específico do Cloud Run em que você quer testar a conectividade. Por exemplo, selecione helloworld-run.
  1. Se o endpoint de origem estiver em um projeto diferente do atual, marque O endpoint está em um projeto diferente de PROJECT_NAME.
  2. Selecione um projeto em que o endpoint existe.
3. No menu Revisão do Cloud Run, selecione uma revisão do Cloud Run em que você está realizando testes.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione Instância de VM.
2. No menu Instância de VM de destino, selecione a instância específica.
3. No menu Interface de rede de destino, selecione a interface de rede.
  
  Se a instância de VM tiver várias interfaces de rede, selecione uma que identifique exclusivamente o local de destino.
4. Opcional: selecione o Endereço IP de destino na lista. O padrão é o endereço IP da instância de VM de destino.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-cloud-run-revision=CLOUD_RUN_REVISION \
    --destination-instance=DESTINATION_INSTANCE \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
CLOUD_RUN_REVISION: o URI da revisão do Cloud Run de origem, como projects/myproject/locations/us-central1/revisions/cloudrun-revision.
DESTINATION_INSTANCE: o URI da VM de destino, como projects/myproject/zones/us-east1-b/instances/instance-2.
DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino em que você está realizando o teste. Ele precisa ser um dos endereços IP da instância de VM de destino.
PROTOCOL: os protocolos de rede aceitos pelos conectores de acesso VPC sem servidor, ou seja, TCP ou UDP.

API

Use o método projects.locations.global.connectivityTests.create.

POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
{
  "source": {
    "cloudRunRevision": {
      "uri": "CLOUD_RUN_REVISION",
      },
  },
    "destination": {
      "instance": "DESTINATION_INSTANCE",
      "ipAddress": "DESTINATION_IP_ADDRESS"
      },
    "protocol": "PROTOCOL",
  }'

Substitua:

PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
CLOUD_RUN_REVISION: o URI da revisão do Cloud Run de origem, como projects/myproject/locations/us-central1/revisions/cloudrun-revision.
DESTINATION_INSTANCE: o URI da VM de destino, como projects/myproject/zones/us-east1-b/instances/instance-2.
DESTINATION_IP_ADDRESS: o endereço IP da instância de VM de destino em que você está realizando o teste. Ele precisa ser um dos endereços IP da instância de VM de destino.
PROTOCOL: os protocolos de rede aceitos pelos conectores de acesso VPC sem servidor, ou seja, TCP ou UDP.

Testar a conectividade de uma revisão de um serviço do Cloud Run com um endereço IP

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
Insira um nome para o teste.
Selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione Cloud Run.
2. No menu Serviço do Cloud Run, selecione o serviço específico do Cloud Run em que você quer testar a conectividade. Por exemplo, selecione helloworld-run.
  1. Se o endpoint de origem estiver em um projeto diferente do atual, marque O endpoint está em um projeto diferente de PROJECT_NAME.
  2. Selecione um projeto em que o endpoint existe.
3. No menu Revisão do Cloud Run, selecione uma revisão do Cloud Run em que você está realizando testes.
Em Destino, selecione Endereço IP e insira um endereço IP.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-cloud-run-revision=CLOUD_RUN_REVISION \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
CLOUD_RUN_REVISION: o URI da revisão do Cloud Run de origem, como projects/myproject/locations/us-central1/revisions/cloudrun-revision.
DESTINATION_IP_ADDRESS: o endereço IP de destino externo em que você está realizando testes.
PROTOCOL: os protocolos de rede aceitos pelos conectores de acesso VPC sem servidor, ou seja, TCP ou UDP.

API

Use o método projects.locations.global.connectivityTests.create.

POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
{
  "source": {
    "cloudRunRevision": {
      "uri": "CLOUD_RUN_REVISION",
      },
  },
    "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      },
    "protocol": "PROTOCOL",
  }'

Substitua:

PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
CLOUD_RUN_REVISION: o URI da revisão do Cloud Run de origem, como projects/myproject/locations/us-central1/revisions/cloudrun-revision.
DESTINATION_IP_ADDRESS: o endereço IP de destino externo em que você está realizando testes.
PROTOCOL: os protocolos de rede aceitos pelos conectores de acesso VPC sem servidor, ou seja, TCP ou UDP.

Testar a conectividade de uma revisão de um serviço do Cloud Run com um serviço gerenciado pelo Google

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
Insira um nome para o teste.
Selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione Cloud Run.
2. No menu Serviço do Cloud Run, selecione o serviço específico do Cloud Run em que você quer testar a conectividade. Por exemplo, selecione helloworld-run.
  1. Se o endpoint de origem estiver em um projeto diferente do atual, marque O endpoint está em um projeto diferente de PROJECT_NAME.
  2. Selecione um projeto em que o endpoint existe.
3. No menu Revisão do Cloud Run, selecione uma revisão do Cloud Run em que você está realizando testes.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione um tipo de recurso de serviço gerenciado pelo Google, como o plano de controle do cluster do GKE.
2. No menu Plano de controle do cluster do GKE de destino, selecione o cluster em que você quer testar a conectividade com o plano de controle do GKE.
3. Opcional: selecione o endpoint do plano de controle do cluster do GKE de destino na lista. O padrão é o endpoint baseado em IP do cluster do GKE.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-cloud-run-revision=CLOUD_RUN_REVISION \
      DESTINATION_RESOURCE_FLAG=DESTINATION_ENDPOINT \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
CLOUD_RUN_REVISION: o URI da revisão do Cloud Run de origem, como projects/myproject/locations/us-central1/revisions/cloudrun-revision.
PROJECT_NAME: o nome do projeto em que o endpoint está, como myproject.
DESTINATION_RESOURCE_FLAG: a flag que especifica o tipo de recurso de serviço gerenciado pelo Google.

Para as opções disponíveis, consulte:
- --destination-gke-master-cluster
- --destination-cloud-sql-instance
Para mais informações, consulte a referência de gcloud network-management connectivity-tests create.
DESTINATION_ENDPOINT: o URI do endpoint de destino. Por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1 para a flag --destination-gke-master-cluster.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP. O padrão é a porta 80.
PROTOCOL: os protocolos de rede aceitos pelos conectores de acesso VPC sem servidor, ou seja, TCP ou UDP.

API

Use o método projects.locations.global.connectivityTests.create.

POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
{
  "source": {
    "cloudRunRevision": {
      "uri": "CLOUD_RUN_REVISION",
      },
  },
    "destination": {
      "DESTINATION_RESOURCE_FIELD": "DESTINATION_ENDPOINT",
      "port": DESTINATION_PORT,
    },
    "protocol": "PROTOCOL",
  }'

Substitua:

PROJECT_ID: o ID do projeto da função do Cloud Run de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
CLOUD_RUN_REVISION: o URI da revisão do Cloud Run de origem, como projects/myproject/locations/us-central1/revisions/cloudrun-revision.
DESTINATION_RESOURCE_FIELD: o campo que especifica o tipo de recurso de serviço gerenciado pelo Google.

Para as opções disponíveis, consulte:
- gkeMasterCluster
- cloudSqlInstance
- redisInstance
- redisCluster
Para mais informações, consulte a referência do endpoint.
DESTINATION_ENDPOINT: o URI do endpoint de destino. Por exemplo, projects/myproject/locations/us-central1/clusters/cluster-1 para o campo gkeMasterCluster.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP. O padrão é a porta 80.
PROTOCOL: os protocolos de rede aceitos pelos conectores de acesso VPC sem servidor, ou seja, TCP ou UDP.

Testar a conectividade de uma rede VPC com uma rede que não é doGoogle Cloud

Para testar a conectividade de uma rede VPC com uma rede que não é doGoogle Cloud , siga as etapas a seguir.

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, selecione Endereço IP e insira um endereço IP.
1. Se a rede VPC estiver em outro projeto, selecione Este é um endereço IP usado no Google Cloud. Em seguida, no campo Projeto de serviço ou endereço IP de origem, selecione o projeto em que a rede está.
2. Se o endereço IP privado estiver fora do espaço de endereços RFC 1918, marque a caixa de seleção Confirmo que o endpoint de origem está em um intervalo fora do espaço de endereços RFC 1918 e selecione a rede de origem em que ele está.
Em Destino, selecione Endereço IP e insira um endereço IP externo.
Desmarque Este é um endereço IP usado no Google Cloud.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Insira o comando a seguir para testar a conectividade entre endereços IP internos e externos. Substitua as variáveis das opções de comando pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-ip-address=SOURCE_IP_ADDRESS \
    --source-network=SOURCE_NETWORK \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_NETWORK: o URI da rede VPC em que o endereço IP de origem está, como projects/myproject/global/networks/default.
DESTINATION_IP_ADDRESS: o endereço IP de destino externo em que você está realizando testes.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

API

Este exemplo testa a capacidade de fazer ping do endereço IP de origem para o de destino.

Use o método projects.locations.global.connectivityTests.create.

  POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "network": "SOURCE_NETWORK"
    },
    "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "port": "DESTINATION_PORT",
    },
      "protocol": "PROTOCOL".
  }'

Substitua:

PROJECT_ID: o ID do projeto da VM de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_NETWORK: o URI da rede VPC em que o endereço IP de origem está, como projects/myproject/global/networks/default.
DESTINATION_IP_ADDRESS: o endereço IP de destino externo em que você está realizando testes.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Python

O código de exemplo a seguir cria um teste entre dois endereços IP. Para mais informações, consulte create na biblioteca de cliente da API do Google para Python.

test_input = {
  "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "projectId": "SOURCE_IP_PROJECT_ID"
  },
  "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "port": "DESTINATION_PORT",
  },
  "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

Substitua:

SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_IP_PROJECT_ID: o ID do projeto do endereço IP de origem.
DESTINATION_IP_ADDRESS: o endereço IP de destino externo em que você está realizando testes.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
PROJECT_ID: o ID do projeto em que você está criando o teste.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

O exemplo abaixo cria um teste entre dois endereços IP:

test_input = {
    "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "networkType": "GCP_NETWORK"
    },
    "destination": {
        "ipAddress": "DESTINATION_IP_ADDRESS",
        "port": "DESTINATION_PORT",
    },
    "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
  parent="projects/PROJECT_ID/locations/global",
  testId="TEST_ID",
  body=test_input)

print(json.dumps(request.execute(), indent=4))

Substitua:

SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_NETWORK_TYPE: o tipo de rede em que a origem está. Neste caso, use o valor GCP_NETWORK.
DESTINATION_IP_ADDRESS: o endereço IP do destino.
DESTINATION_PORT: o número da porta TCP ou UDP de destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
PROJECT_ID: o ID do projeto em que você está criando o teste.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Testar a conectividade de um spoke VPC com outro conectado ao mesmo hub do Network Connectivity Center

Para testar a conectividade de um spoke VPC em um hub do Network Connectivity Center com outro conectado ao mesmo hub, siga as etapas a seguir.

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, selecione Endereço IP e insira o endereço IP da rede VPC spoke de origem.
Em Destino, selecione Endereço IP e insira o endereço IP em outra rede VPC spoke em que você está realizando testes.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Digite o comando a seguir para testar a conectividade entre dois spokes. Substitua as variáveis das opções de comando pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-ip-address=SOURCE_IP_ADDRESS \
    --source-network=SOURCE_NETWORK \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_NETWORK: o URI da rede VPC em que o endereço IP de origem está, como projects/myproject/global/networks/default.
DESTINATION_IP_ADDRESS: o endereço IP de destino em outra rede VPC spoke em que você está realizando testes.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

API

Este exemplo testa a capacidade de fazer ping do endereço IP de origem para o de destino.

Use o método projects.locations.global.connectivityTests.create.

  POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "network": "SOURCE_NETWORK"
    },
    "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "port": "DESTINATION_PORT",
    },
      "protocol": "PROTOCOL".
  }'

Substitua:

PROJECT_ID: o ID do projeto da VM de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_NETWORK: o URI da rede VPC em que o endereço IP de origem está, como projects/myproject/global/networks/default.
DESTINATION_IP_ADDRESS: o endereço IP de destino em outra rede VPC spoke em que você está realizando testes.
DESTINATION_PORT: o número da porta TCP ou UDP de destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Python

O código de exemplo a seguir cria um teste entre dois endereços IP. Para mais informações, consulte o método create na biblioteca de cliente das APIs do Google para Python.

test_input = {
  "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "projectId": "SOURCE_IP_PROJECT_ID"
  },
  "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "port": "DESTINATION_PORT",
  },
  "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

Substitua:

SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_IP_PROJECT_ID: o ID do projeto do endereço IP de origem.
DESTINATION_IP_ADDRESS: o endereço IP de destino em outra rede VPC spoke em que você está realizando testes.
DESTINATION_PORT: o número da porta TCP ou UDP de destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
PROJECT_ID: o ID do projeto em que você está criando o teste.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

O exemplo abaixo cria um teste entre dois endereços IP:

test_input = {
    "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "networkType": "GCP_NETWORK"
    },
    "destination": {
        "ipAddress": "DESTINATION_IP_ADDRESS",
        "port": "DESTINATION_PORT",
    },
    "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
  parent="projects/PROJECT_ID/locations/global",
  testId="TEST_ID",
  body=test_input)

print(json.dumps(request.execute(), indent=4))

Substitua:

SOURCE_IP_ADDRESS: o endereço IP de origem para o teste.
SOURCE_NETWORK_TYPE: o tipo de rede em que a origem está. Neste caso, use o valor GCP_NETWORK.
DESTINATION_IP_ADDRESS: o endereço IP da VM de destino.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
PROJECT_ID: o ID do projeto em que você está criando o teste.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Testar a conectividade de uma VM com uma rede que não é doGoogle Cloud

Este teste analisa a conectividade da VM de origem com um local de borda da rede do Google.

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione Instância de VM.
2. No menu Instância de VM de origem, selecione a instância específica.
3. No menu Interface de rede de origem, selecione a interface de rede.
  
  Se a instância de VM tiver várias interfaces de rede, selecione uma que identifique exclusivamente o local de origem.
4. Opcional: selecione o Endereço IP de origem na lista. O padrão é o endereço IP da instância de VM de origem.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione Endereço IP.
2. Digite um Endereço IP de destino externo.
3. Desmarque Este é um endereço IP usado no Google Cloud.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Para testar a conectividade entre uma VM e um endereço IP externo, insira o comando a seguir. Substitua os valores de exemplo pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-instance=SOURCE_INSTANCE \
    --source-ip-address=SOURCE_IP_ADDRESS \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --destination-port=DESTINATION_PORT \
    --protocol=PROTOCOL

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
DESTINATION_IP_ADDRESS: o endereço IP de destino externo em que você está realizando testes.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

API

O exemplo de teste a seguir determina se a configuração de rede atual permite que a VM instance1 faça um ping no endereço IP de destino.

Use o método projects.locations.global.connectivityTests.create.

 POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
   {
     "source": {
       "instance": "SOURCE_INSTANCE",
       "ipAddress": "SOURCE_IP_ADDRESS",
     },
    "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "port": "DESTINATION_PORT",
     },
     "protocol": "PROTOCOL",
   }'

Substitua:

PROJECT_ID: o ID do projeto da VM de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
DESTINATION_IP_ADDRESS: o endereço IP de destino externo em que você está realizando testes.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Python

O código de exemplo a seguir cria um teste de conectividade entre uma instância de VM e um endereço IP externo. Para mais informações, consulte create na biblioteca de cliente da API do Google para Python.

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "ipAddress":
          "SOURCE_IP_ADDRESS",
      "projectId":
          "SOURCE_INSTANCE_PROJECT_ID"
  },
  "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "port": "DESTINATION_PORT",
  },
  "protocol":
      "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

Substitua:

SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
SOURCE_INSTANCE_PROJECT_ID: o ID do projeto da VM de origem.
DESTINATION_IP_ADDRESS: o endereço IP de destino externo em que você está realizando testes.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
PROJECT_ID: o ID do projeto em que você está criando o teste.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Testar a conectividade de uma VM ou de um endereço IP com um balanceador de carga

Nesta seção, descrevemos como testar a conectividade de uma VM ou de um endereço IP com um balanceador de carga doGoogle Cloud .

A análise de configuração do recurso Testes de Conectividade permite monitorar pacotes simulados para todos os tipos de balanceadores de carga do Google Cloud . O caminho de trace para um balanceador de carga de aplicativo externo também se aplica a balanceadores de carga de rede de proxy externos. Para mais informações, consulte a visão geral do Cloud Load Balancing.

Você pode testar a conectividade com:

Testar a conectividade de uma VM com um balanceador de carga

Esta seção analisa a conectividade da VM de origem com um balanceador de carga.

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione Instância de VM.
2. No menu Instância de VM de origem, selecione a instância específica.
3. No menu Interface de rede de origem, selecione a interface de rede.
  
  Se a instância de VM tiver várias interfaces de rede, selecione uma que identifique exclusivamente o local de origem.
4. Opcional: selecione o Endereço IP de origem na lista. O padrão é o endereço IP da instância de VM de origem.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione Balanceador de carga.
2. No menu Balanceador de carga de destino, selecione o balanceador de carga.
  
  Se o endpoint de destino estiver em um projeto diferente do atual, selecione O endpoint está em um projeto diferente de PROJECT_NAME. Em seguida, no campo Projeto de endpoint de destino, selecione o projeto em que o endpoint está.
3. Selecione a Regra de encaminhamento de destino.
  
  Observação: um balanceador de carga pode ter várias configurações de front-end, e cada uma é representada por uma regra de encaminhamento. Para entender melhor as regras de encaminhamento, consulte Visão geral das regras de encaminhamento.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Para testar a conectividade entre uma VM e um balanceador de carga, insira o comando a seguir.

gcloud network-management connectivity-tests create NAME \
    --source-instance=SOURCE_INSTANCE \
    --source-ip-address=SOURCE_IP_ADDRESS \
    --protocol=PROTOCOL \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --destination-port=DESTINATION_PORT \

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem em que você está realizando testes. Ele precisa ser um dos endereços IP da instância de VM de origem.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
DESTINATION_IP_ADDRESS: o endereço IP de destino externo em que você está realizando testes.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.

API

Use o método projects.locations.global.connectivityTests.create.

 POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
   {
     "source": {
       "instance": "SOURCE_INSTANCE",
       "ipAddress": "SOURCE_IP_ADDRESS",
     },
    "destination": {
      "forwardingRule": "DESTINATION_FORWARDING_RULE",
      "port": "DESTINATION_PORT",
     },
     "protocol": "PROTOCOL",
   }'

Substitua:

PROJECT_ID: o ID do projeto da VM de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.
SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
DESTINATION_FORWARDING_RULE: a regra de encaminhamento de destino que representa o endpoint.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Python

O código de exemplo a seguir cria um teste de conectividade entre uma instância de VM e um endpoint do balanceador de carga. Para mais informações, consulte create na biblioteca de cliente da API do Google para Python.

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "ipAddress":
          "SOURCE_IP_ADDRESS",
      "projectId":
          "SOURCE_INSTANCE_PROJECT_ID"
  },
  "destination": {
      "forwardingRule": "DESTINATION_FORWARDING_RULE",
      "port": "DESTINATION_PORT",
  },
  "protocol":
      "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

Substitua:

SOURCE_INSTANCE: o URI da VM de origem, como projects/myproject/zones/us-east1-b/instances/instance-1.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
SOURCE_INSTANCE_PROJECT_ID: o ID do projeto da VM de origem.
DESTINATION_FORWARDING_RULE: a regra de encaminhamento de destino que representa o endpoint.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
PROJECT_ID: o ID do projeto em que você está criando o teste.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Testar a conectividade de um endereço IP com um balanceador de carga

Console

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione Criar teste de conectividade.
No campo Nome do teste, insira um nome para o teste.
Na lista Protocolo, selecione um protocolo.
Em Origem, faça o seguinte:
1. No menu Endpoint de origem, selecione Endereço IP.
2. No campo Endereço IP de origem, digite o endereço IP de origem.
  1. Se a rede VPC estiver em outro projeto, selecione Este é um endereço IP usado no Google Cloud. Em seguida, no campo Projeto de serviço ou endereço IP de origem, selecione o projeto em que a rede está.
  2. Se o endereço IP estiver fora do espaço de endereços RFC 1918, marque Confirmo que o endpoint de origem está em um intervalo fora do espaço de endereços RFC 1918. Em seguida, na lista Rede de origem, selecione a rede em que o endereço IP de origem está.
Em Destino, faça o seguinte:
1. No menu Endpoint de destino, selecione Balanceador de carga.
2. No menu Balanceador de carga de destino, selecione o endpoint do balanceador de carga.
  
  Se o endpoint de destino estiver em um projeto diferente do atual, selecione O endpoint está em um projeto diferente de PROJECT_NAME. Em seguida, no campo Projeto de endpoint de destino, selecione o projeto em que o endpoint está.
3. Selecione a Regra de encaminhamento de destino.
  
  Observação: um balanceador de carga pode ter várias configurações de front-end, e cada uma é representada por uma regra de encaminhamento. Para entender melhor as regras de encaminhamento, consulte estes conceitos relacionados.
No campo Porta de destino, insira uma porta de destino para o destino especificado.
Clique em Criar.
Quando o teste terminar, a página principal Testes de conectividade será carregada e mostrará uma lista com este e outros testes. Continue para Exibir os resultados do teste.

gcloud

Use o comando gcloud network-management connectivity-tests create. Substitua os valores de exemplo pelos valores da sua rede VPC.

gcloud network-management connectivity-tests create NAME \
    --source-project=SOURCE_PROJECT \
    --source-ip-address=SOURCE_IP_ADDRESS \
    --protocol=PROTOCOL \
    --destination-ip-address=DESTINATION_IP_ADDRESS \
    --destination-port=DESTINATION_PORT \

Substitua:

NAME: o nome do teste de conectividade.
SOURCE_PROJECT: o ID do projeto do endpoint de origem.
SOURCE_IP_ADDRESS: o endereço IP da instância de VM de origem que está sendo testada. Ele precisa ser um dos endereços IP da instância de VM de origem.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
DESTINATION_IP_ADDRESS: o endereço IP de destino externo em que você está realizando testes.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.

Se o endpoint for usado para acessar serviços ou serviços gerenciados em outra rede VPC, especifique a DESTINATION_NETWORK porque ele tem um endereço IP interno.

API

Este exemplo testa a capacidade de fazer ping do endereço IP de origem em um endpoint do balanceador de carga.

Use o método projects.locations.global.connectivityTests.create.

  POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "networkType": "NON_GCP_NETWORK",
    },
    "destination": {
      "forwardingRule": "DESTINATION_FORWARDING_RULE",
      "port": "DESTINATION_PORT",
    },
    "protocol": "PROTOCOL",
  }'

Substitua:

SOURCE_IP_ADDRESS: o endereço IP de origem em que você está realizando testes.
DESTINATION_FORWARDING_RULE: a regra de encaminhamento de destino que representa o endpoint.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.

Se o endpoint for usado para acessar serviços publicados, especifique a DESTINATION_NETWORK porque ele tem um endereço IP interno.

Python

O código de exemplo a seguir cria um teste de conectividade entre um endereço IP e um endpoint do balanceador de carga. Para mais informações, consulte create na biblioteca de cliente da API do Google para Python.

Ao especificar um endereço IP de origem externo aoGoogle Cloud, especifique um networkType que seja NON_GCP_NETWORK.

test_input = {
    "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "networkType": "NON_GCP_NETWORK"
    },
    "destination": {
        "forwardingRule": "DESTINATION_FORWARDING_RULE",
        "port": "DESTINATION_PORT",
        "projectId": "DESTINATION_IP_PROJECT_ID"
    },
    "protocol": "PROTOCOL",
}

  request = api.projects().locations().global_().connectivityTests().create(
  parent="projects/PROJECT_ID/locations/global",
  testId="TEST_ID",
  body=test_input)

print(json.dumps(request.execute(), indent=4))

Substitua:

SOURCE_IP_ADDRESS: o endereço IP de origem em que você está realizando testes.
SOURCE_NETWORK_TYPE: o tipo de rede em que a origem está. Neste caso, use o valor NON_GCP_NETWORK.
DESTINATION_FORWARDING_RULE: a regra de encaminhamento de destino que representa o endpoint.
DESTINATION_PORT: a porta do protocolo IP do destino. Essa opção só é válida para protocolos TCP ou UDP.
DESTINATION_IP_PROJECT_ID: o ID do projeto do endereço IP de destino.
PROTOCOL: um protocolo aceito para os Testes de conectividade. O protocolo padrão é TCP.
PROJECT_ID: o ID do projeto em que você está criando o teste.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Se o endpoint for usado para acessar serviços publicados, especifique a DESTINATION_NETWORK porque ele tem um endereço IP interno.

Testar a conectividade de uma rede que não é doGoogle Cloud com uma rede VPC

Esse procedimento é o mesmo de Testar a conectividade entre endereços IP privados em uma rede VPC, exceto pelas etapas a seguir. Siga este procedimento para o console doGoogle Cloud , a CLI do Google Cloud, exemplos de API e exemplos do Python.

Se o endereço de origem não estiver no Google Cloud , mas não for da rede com peering (local), especifique um endereço IP externo.
Se o endereço de origem for da rede com peering (local), selecione Outra rede que não é do Google Cloud.

Testar a conectividade de uma rede que não é doGoogle Cloud com uma rede que não é doGoogle Cloud

Especifique endereços IP externos para os endereços IP de origem e de destino.
No console do Google Cloud , desmarque Este é um endereço IP usado no Google Cloud.

Exibir os resultados dos testes

Nesta seção, você vai aprender a visualizar os resultados de um teste de conectividade.

Console

É possível ver um teste de várias páginas diferentes.

Na página principal dos Testes de conectividade

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Na coluna Detalhes do resultado, escolha um teste e clique em Visualizar.
O painel de informações do teste é exibido. É possível visualizar o resultado geral e os cards de resultado de cada recurso do Google Cloud no caminho do teste. É possível clicar em um link para a página de detalhes de alguns recursos do Google Cloud, como instâncias de VM ou rotas. Se o teste contiver vários traces, será possível selecionar um na lista Resultado do trace.

Se o teste estiver qualificado para a análise do plano de dados ativo, será possível conferir as métricas de perda de pacotes e latência.
Para expandir ou fechar um card de resultados, clique na seta à direita do card.
Para interpretar os resultados do teste, consulte Estados da análise da configuração.
Para fechar o painel de informações, no canto superior direito da página, clique em Ocultar painel de informações.

Na página de detalhes do teste de conectividade

Como alternativa, na página principal do console do Google Cloud , clique no nome de um teste e confira os resultados dele na página Detalhes do teste de conectividade.

Na página de detalhes da interface de rede

Também é possível ver os resultados da página Detalhes da interface de rede para uma interface de rede de uma instância de VM do Compute Engine. Nesta página, listamos apenas os testes que usam a interface de rede atual como origem ou destino.

Para conferir os resultados, selecione Visualizar na coluna Detalhes do resultado ou clique no nome do teste.

gcloud

Para visualizar os resultados de um teste, digite o seguinte comando. Use o ID do teste que você quer ver.

gcloud network-management connectivity-tests describe NAME

Substitua NAME pelo nome do teste de conectividade.

API

Use o método projects.locations.global.connectivityTests.get para visualizar os resultados de um teste.

  GET https://networkmanagement.googleapis.com/v1/{name=projects/PROJECT_ID/locations/global/connectivityTests/TEST_ID}

Substitua:

PROJECT_ID: o ID do projeto da VM de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Python

O código de exemplo a seguir exibe os resultados de um teste. Para mais informações, consulte get na biblioteca de cliente da API do Google para Python.

project_id = "PROJECT_ID"
test_id= "TEST_ID"
request = api.projects().locations().global_().connectivityTests().get(
      name='projects/%s/locations/global/connectivityTests/%s' %
      (project_id, test_id))

print(json.dumps(request.execute(), indent=4))

Substitua:

PROJECT_ID: o ID do projeto em que o teste foi criado.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Executar novamente um ou mais testes

Você pode executar novamente um teste de conectividade ao fazer alterações na configuração dos recursos do Google Cloud no caminho do teste para conferir os resultados da última configuração de rede. É possível executar novamente um ou mais testes ao mesmo tempo.

Um teste de conectividade é baseado em um instantâneo da configuração de rede no momento da execução. Executar novamente um teste substitui os resultados anteriores. Se você quiser preservar resultados mais antigos, crie um teste.

Para verificar o status da operação rerun do teste durante a execução, consulte como verificar uma operação de teste em execução.

Console

Na página principal dos Testes de conectividade

No console do Google Cloud , acesse a página Testes de conectividade.
Acessar Testes de conectividade
Selecione um ou mais testes na lista Testes de conectividade disponíveis.
Clique em Executar novamente.

Na página de detalhes dos Testes de conectividade

Na página principal Testes de conectividade anterior, clique no nome de um teste.
Na parte superior da página Detalhes do teste de conectividade, clique em Executar novamente.

Na página de detalhes da interface de rede

No console do Google Cloud , acesse a página Instâncias de VM.
Acessar Instâncias de VM
Selecione o projeto que contém a instância em que você quer executar novamente um teste, se ele ainda não estiver selecionado.
Clique na instância que você quer usar para executar novamente um teste.
Em Interfaces de rede, selecione a interface de rede que você quer usar para executar novamente um teste.
Em Análise de rede, clique em Testes de conectividade.
Selecione um ou mais testes na lista Testes de conectividade disponíveis.
Clique em Executar novamente.

gcloud

Para executar novamente um teste de conectividade, insira o seguinte comando. Use o ID de teste que você quer executar novamente.

gcloud network-management connectivity-tests rerun NAME

Substitua NAME pelo nome do teste de conectividade.

API

Quando a API de gerenciamento de rede cria um recurso connectivityTests, ele retém esse recurso de teste até você excluí-lo. Por esse motivo, você pode executar novamente os testes.

Se você não quiser criar testes persistentes, use a API para criar um teste e exclua-o após visualizar o resultado.

Use o método projects.locations.global.connectivityTests.rerun para executar novamente um teste.

  POST https://networkmanagement.googleapis.com/v1/{name=projects/*/locations/global/connectivityTests/*}:rerun
    {
      "name": {projects/PROJECT_ID/connectivityTests/{TEST_ID}}
    }

Substitua:

PROJECT_ID: o ID do projeto da VM de origem.
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Python

O código de exemplo a seguir executa um teste novamente. Para mais informações, consulte rerun na biblioteca de cliente da API do Google para Python.

project_id = "PROJECT_ID"
test_id = "TEST_ID"
request = api.projects().locations().global_().connectivityTests().rerun(name='projects/%s/locations/global/connectivityTests/%s' % (project_id, test_id))

print(json.dumps(request.execute(), indent=4))

Substitua os seguintes valores:

PROJECT_ID: o ID do projeto em que o teste foi criado;
TEST_ID: o ID do objeto dos Testes de conectividade (teste) que você está executando.

Criar e executar Testes de conectividade Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Executar os Testes de conectividade

Práticas recomendadas

Realizar testes em uma VM com várias interfaces de rede

Console

gcloud e API

Listar todos os testes para um projeto

Console

gcloud

API

Python

Testes entre instâncias de VM em uma rede VPC

Console

Na página principal dos Testes de conectividade

Na página de detalhes da interface de rede

gcloud

Terraform

API

Python

Teste entre endereços IP privados em uma rede VPC

Console

gcloud

Terraform

API

Python

Testar endereços IP em uma rede VPC compartilhada

Console: no host

Console: no serviço

gcloud

API

Python

Testar a conectividade de uma VM com um serviço gerenciado pelo Google

Console

Na página principal dos Testes de conectividade

Na página de detalhes da interface de rede

gcloud

API

Python

Testar a conectividade de uma VM com endpoints do Private Service Connect

Console

gcloud

API

Python

Testar a conectividade de uma versão do ambiente padrão do App Engine com um destino

Testar a conectividade de uma versão de um serviço do ambiente padrão do App Engine com uma instância de VM

Console

gcloud

API

Testar a conectividade de uma versão de um serviço do ambiente padrão do App Engine com um endereço IP

Console

gcloud

API

Testar a conectividade de uma versão de um serviço do ambiente padrão do App Engine com um serviço gerenciado pelo Google

Console

gcloud

API

Testar a conectividade de uma função do Cloud Run com um destino

Testar a conectividade de uma função do Cloud Run com uma instância de VM

Console

gcloud

API

Testar a conectividade de uma função do Cloud Run com um endereço IP

Console

gcloud

API

Testar a conectividade de uma função do Cloud Run com um serviço gerenciado pelo Google

Console

gcloud

Testar a conectividade de uma revisão do Cloud Run com um destino

Testar a conectividade de uma revisão de um serviço do Cloud Run com uma instância de VM

Console

gcloud

API

Testar a conectividade de uma revisão de um serviço do Cloud Run com um endereço IP

Console

gcloud

API

Testar a conectividade de uma revisão de um serviço do Cloud Run com um serviço gerenciado pelo Google

Console

Criar e executar Testes de conectividade