Atualizar ou excluir testes

Siga as etapas nesta página para aprender a editar ou excluir testes. Isso pode ser feito com os testes criados por você e por outras pessoas.

Para criar, visualizar ou executar testes novamente, leia Criar e executar testes de conectividade.

Para saber mais sobre o recurso Testes de Conectividade, consulte a visão geral.

Antes de começar

Antes de usar o recurso Testes de Conectividade, configure os seguintes itens em Google Cloud:

  1. No console do Google Cloud , acesse a página Seletor de Projetos.

    Acessar o seletor de projetos

    Selecione ou crie um projeto do Google Cloud .

  2. Verifique se o faturamento está ativado para o projeto do Google Cloud .

  3. Instale a CLI do Google Cloud, que faz parte da CLI do Google Cloud. Para instalar a versão mais recente da gcloud CLI, consulte a documentação da gcloud CLI.

    Para ver uma lista de todos os comandos, consulte a referência do comando do gcloud.

  4. Ative a API Network Management. Isso 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 API para explorar os campos da API e executar um teste.

    • Exemplo de código que usa o cliente Python da API.

      O exemplo de código pressupõe que você tenha criado um recurso chamado api para interagir com a API Network Management. Para criar um recurso, use a função build. Confira o seguinte exemplo:

      from googleapiclient.discovery import build
api = build('networkmanagement', 'v1')

      Para mais informações sobre o cliente Python da API, acesse:

  5. 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 update do teste durante a execução, consulte Verificar uma operação de teste em execução.

Console

Na página principal do recurso Testes de Conectividade

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

    Acesse os Testes de Conectividade

  2. Para atualizar um teste, clique no nome dele.

  3. Na página Detalhes do teste de conectividade, clique em Editar na parte superior da página.

  4. Modifique as opções do teste.

  5. Clique em Salvar.

    O teste é executado automaticamente outra vez.

Na página de detalhes da interface de rede

  1. No console do Google Cloud , acesse a página Instâncias de VM.

    Acesse as Instâncias de VM

  2. Selecione o projeto que contém a instância em que você quer atualizar um teste, caso isso ainda não tenha sido feito.

  3. Clique na instância em que você quer atualizar um teste.

  4. Em Interfaces de rede, selecione a interface em que você quer atualizar um teste.

  5. Em Análise de rede, clique em Testes de Conectividade.

  6. Clique no nome de um teste para atualizar.

  7. Na página Detalhes do teste de conectividade, clique em Editar na parte superior da página.

  8. Modifique as opções do teste.

  9. Clique em Salvar.

    O teste é executado automaticamente outra vez.

gcloud

Para atualizar um teste, insira o comando a seguir 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 conectividade.
  • DESTINATION_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 dos Testes de Conectividade (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 exemplo de código 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 criado.
  • TEST_ID: o ID do objeto dos Testes de Conectividade (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.

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 delete do teste durante a execução, consulte Verificar uma operação de teste em execução.

Console

Na página principal do recurso Testes de Conectividade

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

    Acesse os Testes de Conectividade

  2. Clique na caixa de seleção à esquerda de um ou mais testes para excluir.

  3. Na parte de cima da página do console do Google Cloud , clique em Excluir.

Na página "Detalhes do teste de conectividade"

  1. Na página principal dos Testes de Conectividade, clique no nome de um teste.
  2. Na parte superior da página Detalhes do teste de conectividade, clique em Excluir .

Na página de detalhes da interface de rede

  1. No console do Google Cloud , acesse a página Instâncias de VM.

    Acesse as Instâncias de VM

  2. Selecione o projeto que contém a instância em que você quer excluir um teste se isso ainda não tiver sido feito.

  3. Clique na instância em que você quer excluir um teste.

  4. Em Interfaces de rede, selecione a interface de rede em que você quer excluir um teste.

  5. Em Análise de rede, clique em Testes de Conectividade.

  6. Marque a caixa de seleção à esquerda de um ou mais testes que você queira excluir.

  7. 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 origem.
  • TEST_ID: o ID do objeto dos Testes de Conectividade (teste) que você está executando.

Python

O exemplo de código 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 criado
  • TEST_ID: o ID do objeto dos Teste de Conectividade (teste) que você está excluindo

A seguir