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

Before you can use Connectivity Tests, set up the following items in Google Cloud:

  1. In the Google Cloud console, go to the project selector page.

    Go to the project selector

    Select or create a Google Cloud project.

  2. Ensure that billing is enabled for your Google Cloud project.

  3. Install the Google Cloud CLI, which is part of the Google Cloud CLI. To install the latest version of the gcloud CLI, see the gcloud CLI documentation.

    For a list of all commands, see the gcloud command reference.

  4. Enable the Network Management API. Enabling the API provides you with the following:

    • Example API calls that use the Network Management API

      You can test Network Management API commands by using the API Explorer. In the Network Management API reference document, use the Try this API column to explore API fields and run a test.

    • Sample code that uses the API Python client

      The example code assumes that you have constructed a resource named api to interact with the Network Management API. To construct a resource, use the build function. See the following example:

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

      For more information about the API Python client, see the following:

  5. Obtain the permissions that you need to run and view tests. For details, see Assign access.

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