Aprenda a editar ou excluir testes, seguindo as etapas nesta página. Você pode editar ou excluir testes criados por você e por outras pessoas.
Para criar, visualizar ou executar novamente testes, leia Criar e executar Testes de conectividade.
Para saber mais sobre o Connectivity Tests, consulte a visão geral.
Antes de começar
Antes de usar o Connectivity Tests, configure os seguintes itens no Google Cloud:
No console do Google Cloud, acesse a página do seletor de projetos.
Selecione ou crie um projeto do Google Cloud.
- Verifique se o faturamento está ativado no seu projeto do 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 APIs Explorer. No documento de referência da API Network Management, use a coluna
Try this APIpara 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
apipara interagir com a API Network Management. Para criar um recurso, use a funçãobuild. 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.
Atualizar um teste
Siga as etapas nesta seção para atualizar um teste. Você pode alterar qualquer campo,
exceto o name do teste.
Para verificar o status da operação de teste update durante a execução, consulte
Verificar uma operação de teste em execução.
Console
Na página principal de testes de conectividade
No console do Google Cloud, acesse a página Testes de conectividade.
Para atualizar um teste, clique no nome dele.
Na página Detalhes do teste de conectividade, clique em Editar na parte superior da página.
Modifique as opções de teste.
Clique em Save.
O teste é executado automaticamente outra vez.
Na página de detalhes da interface de rede
No console do Google Cloud, acesse a página Instâncias de VMs.
Se ainda não estiver selecionado, selecione o projeto que contém a instância em que você quer atualizar um teste.
Clique na instância em que você quer atualizar um teste.
Em Interfaces de rede, selecione a interface de rede em que você quer atualizar um teste.
Em Análise de rede, clique em Testes de conectividade.
Clique no nome de um teste para atualizar.
Na página Detalhes do teste de conectividade, clique em Editar na parte superior da página.
Modifique as opções de teste.
Clique em Save.
O teste é executado automaticamente outra vez.
gcloud
Para atualizar um teste, insira o seguinte comando usando o ID do teste que você quer atualizar e as opções de comando que quer alterar. O exemplo a seguir altera o endereço IP de destino.
gcloud network-management connectivity-tests update NAME \
--destination-ip-address= DESTINATION_IP_ADDRESS
Substitua os seguintes valores:
NAME: o nome do teste de conectividadeDESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo que você está testando. Um endereço IPv6 só é permitido quando o destino do teste é um VIP do balanceador de carga global
API
Use o método networkmanagement.connectivitytests.patch para atualizar (editar) um teste.
PATCH https: //networkmanagement.googleapis.com/v1/{resource.name=projects/PROJECT_ID/locations/global/connectivityTests/TEST_ID}
{
"source": {
"ipAddress": "SOURCE_IP_ADDRESS",
"projectId": "SOURCE_PROJECT",
},
}
Substitua os seguintes valores:
PROJECT_ID: o ID do projeto da VM de origem;TEST_ID: o ID do objeto do Connectivity Tests (teste) que você está executando;SOURCE_IP_ADDRESS: o endereço IP de origem interna ou externa que você está testando. Um endereço IPv6 só é permitido quando o destino do teste é um VIP do balanceador de carga global;SOURCE_PROJECT: o ID do projeto do endpoint de origem
Python
O código de exemplo a seguir atualiza o endereço IP de origem para um teste. Para mais
informações, consulte patch
na documentação de referência do cliente Python da API.
project_id = "PROJECT_ID"
test_id = "TEST_ID"
test_input = {
"source": {
"ipAddress": "SOURCE_IP_ADDRESS"
},
}
request = api.projects().locations().global_().connectivityTests().patch(
name='projects/%s/locations/global/connectivityTests/%s' % (project_id, test_id),
body=test_input,
updateMask="source")
print(json.dumps(request.execute(), indent=4))
Substitua os seguintes valores:
PROJECT_ID: o ID do projeto em que o teste foi criadoTEST_ID: o ID do objeto de teste de conectividade (teste) que você está executandoSOURCE_IP_ADDRESS: o endereço IP de origem interno ou externo que você está testando. Um endereço IPv6 só é permitido quando o destino do teste é um VIP do balanceador de carga global
updateMask é um parâmetro obrigatório que especifica os campos atualizados pelo patch. Este exemplo atualiza o campo source.
Excluir um ou mais testes
Siga as etapas nesta seção para excluir um teste.
Para verificar o status da operação de teste delete durante a execução, consulte
Verificar uma operação de teste em execução.
Console
Na página principal de testes de conectividade
No console do Google Cloud, acesse a página Testes de conectividade.
Clique na caixa de seleção à esquerda de um ou mais testes para excluir.
Na parte superior da página do console do Google Cloud, clique em Excluir .
Na página de detalhes do teste de conectividade
- Na página principal Testes de conectividade, clique no nome de um teste.
- Na parte superior da página Detalhes do teste de conectividade, clique em Excluir .
Na página de detalhes da interface de rede
No console do Google Cloud, acesse a página Instâncias de VMs.
Se ainda não estiver selecionado, selecione o projeto que contém a instância da qual você quer excluir um teste.
Clique na instância da qual você quer excluir um teste.
Em Interfaces de rede, selecione a interface de rede de qual você quer excluir um teste.
Em Análise de rede, clique em Testes de conectividade.
Marque a caixa de seleção à esquerda de um ou mais testes que você quer excluir.
Na parte superior da lista de testes, clique em Excluir .
gcloud
Para excluir um teste, digite o seguinte comando. Use o ID do teste que você quer excluir.
gcloud beta network-management connectivity-tests delete NAME
Substitua NAME pelo nome do
teste de conectividade.
API
Use o método networkmanagement.connectivitytests.delete para excluir um teste.
DELETE https://networkmanagement.googleapis.com/v1/{name=projects/PROJECT_ID/locations/global/connectivityTests/{TEST_ID}
Substitua os seguintes valores:
PROJECT_ID: o ID do projeto da VM de origemTEST_ID: o ID do objeto de teste de conectividade (teste) que você está executando
Python
O código de exemplo a seguir exclui um teste. Para mais informações, consulte
delete
na documentação de referência do cliente Python da API.
project_id = "PROJECT_ID"
test_id = "TEST_ID"
request = api.projects().locations().global_().connectivityTests().delete(
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 criadoTEST_ID: o ID do objeto de teste de conectividade (teste) que você está excluindo