Saiba como editar ou eliminar testes seguindo os passos descritos nesta página. Pode editar ou eliminar testes criados por si e por outras pessoas.
Para criar, ver ou executar novamente testes, consulte o artigo Crie e execute testes de conetividade.
Para saber mais sobre os testes de conetividade, consulte a vista geral.
Antes de começar
Antes de poder usar os testes de conetividade, configure os seguintes itens em Google Cloud:
Na Google Cloud consola, aceda à página do seletor de projetos.
Selecione ou crie um Google Cloud projeto.
- Certifique-se de que a faturação está ativada para o seu Google Cloud projeto.
Instale a CLI Google Cloud, que faz parte da CLI Google Cloud. Para instalar a versão mais recente da CLI gcloud, consulte a documentação da CLI gcloud.
Para ver uma lista de todos os comandos, consulte a referência de comandos
gcloud.Ative a API Network Management. A ativação da API oferece-lhe o seguinte:
Exemplos de chamadas de API que usam a API Network Management
Pode testar comandos da API Network Management através do API 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 Python da API
O código de exemplo pressupõe que criou um recurso denominado
apipara interagir com a API Network Management. Para criar um recurso, use a funçãobuild. Veja o exemplo seguinte:from googleapiclient.discovery import build api = build('networkmanagement', 'v1')Para mais informações sobre o cliente Python da API, consulte o seguinte:
- Documentos da biblioteca cliente da API Google para Python no GitHub, que incluem instruções de instalação e autenticação.
- A documentação de referência da API Network Management para o cliente Python da API.
- Obtenha as autorizações de que precisa para executar e ver testes. Para ver detalhes, consulte a secção Atribua acesso.
Atualize um teste
Siga os passos nesta secção para atualizar um teste. Pode alterar qualquer campo, exceto o name do teste.
Para verificar o estado da operação de teste enquanto está em execução, consulte o artigo
Verifique uma operação de teste em execução.update
Consola
A partir da página principal de testes de conetividade
Na Google Cloud consola, aceda à página Testes de conetividade.
Para atualizar um teste, clique no respetivo nome.
Na página Detalhes do teste de conetividade, clique em Editar na parte superior da página.
Modifique as opções de teste.
Clique em Guardar.
O teste é executado novamente de forma automática.
Na página de detalhes da interface de rede
Na Google Cloud consola, aceda à página Instâncias de VM.
Se ainda não estiver selecionado, selecione o projeto que contém a instância para a qual quer atualizar um teste.
Clique na instância para a qual quer atualizar um teste.
Em Interfaces de rede, selecione a interface de rede para a qual quer atualizar um teste.
Em Análise de rede, clique em Testes de conetividade.
Clique no nome de um teste para o atualizar.
Na página Detalhes do teste de conetividade, clique em Editar na parte superior da página.
Modifique as opções de teste.
Clique em Guardar.
O teste é executado novamente de forma automática.
gcloud
Para atualizar um teste, introduza o seguinte comando com o ID do teste que quer atualizar e as opções de comando que quer alterar. O exemplo seguinte 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 conetividadeDESTINATION_IP_ADDRESS: o endereço IP de destino interno ou externo para o qual está a fazer o teste; só é permitido um endereço IPv6 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 origemTEST_ID: o ID do objeto Connectivity Tests (teste) que está a executarSOURCE_IP_ADDRESS: o endereço IP de origem interno ou externo a partir do qual está a fazer o teste; só é permitido um endereço IPv6 quando o destino do teste é um VIP do balanceador de carga globalSOURCE_PROJECT: o ID do projeto do ponto final de origem
Python
O exemplo de código seguinte 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 no qual o teste foi criadoTEST_ID: o ID do objeto Connectivity Tests (teste) que está a executarSOURCE_IP_ADDRESS: o endereço IP de origem interno ou externo a partir do qual está a fazer o teste; só é permitido um endereço IPv6 quando o destino do teste é um VIP do balanceador de carga global
updateMask é um parâmetro obrigatório que especifica os campos que a sua atualização
atualiza. Este exemplo atualiza o campo source.
Elimine um ou mais testes
Siga os passos nesta secção para eliminar um teste.
Para verificar o estado da operação de teste enquanto está em execução, consulte o artigo
Verifique uma operação de teste em execução.delete
Consola
A partir da página principal de testes de conetividade
Na Google Cloud consola, aceda à página Testes de conetividade.
Clique na caixa de verificação à esquerda de um ou mais testes para os eliminar.
Na parte superior da Google Cloud página da consola, clique em Eliminar .
Na página de detalhes do teste de conetividade
- Na página principal Testes de conetividade, clique no nome de um teste.
- Na parte superior da página Detalhes do teste de conetividade, clique em Eliminar .
Na página de detalhes da interface de rede
Na Google Cloud consola, aceda à página Instâncias de VM.
Se ainda não estiver selecionado, selecione o projeto que contém a instância a partir da qual quer eliminar um teste.
Clique na instância a partir da qual quer eliminar um teste.
Em Interfaces de rede, selecione a interface de rede a partir da qual quer eliminar um teste.
Em Análise de rede, clique em Testes de conetividade.
Selecione a caixa de verificação à esquerda de um ou mais testes que quer eliminar.
Na parte superior da lista de testes, clique em Eliminar .
gcloud
Para eliminar um teste, introduza o seguinte comando. Use o ID do teste que quer eliminar.
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 eliminar 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 Connectivity Tests (teste) que está a executar
Python
O exemplo de código seguinte elimina 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 no qual o teste foi criadoTEST_ID: o ID do objeto Connectivity Tests (teste) que está a eliminar