Atualize ou elimine testes

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

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

      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 API para explorar os campos da API e executar um teste.

    • 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.

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

  1. Na Google Cloud consola, aceda à página Testes de conetividade.

    Aceda a Testes de conetividade

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

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

  4. Modifique as opções de teste.

  5. Clique em Guardar.

    O teste é executado novamente de forma automática.

Na página de detalhes da interface de rede

  1. Na Google Cloud consola, aceda à página Instâncias de VM.

    Aceder às instâncias de VM

  2. Se ainda não estiver selecionado, selecione o projeto que contém a instância para a qual quer atualizar um teste.

  3. Clique na instância para a qual quer atualizar um teste.

  4. Em Interfaces de rede, selecione a interface de rede para a qual quer atualizar um teste.

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

  6. Clique no nome de um teste para o atualizar.

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

  8. Modifique as opções de teste.

  9. 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 conetividade
  • DESTINATION_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 origem
  • TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar
  • SOURCE_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
  • SOURCE_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 criado
  • TEST_ID: o ID do objeto Connectivity Tests (teste) que está a executar
  • SOURCE_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

  1. Na Google Cloud consola, aceda à página Testes de conetividade.

    Aceda a Testes de conetividade

  2. Clique na caixa de verificação à esquerda de um ou mais testes para os eliminar.

  3. Na parte superior da Google Cloud página da consola, clique em Eliminar .

Na página de detalhes do teste de conetividade

  1. Na página principal Testes de conetividade, clique no nome de um teste.
  2. Na parte superior da página Detalhes do teste de conetividade, clique em Eliminar .

Na página de detalhes da interface de rede

  1. Na Google Cloud consola, aceda à página Instâncias de VM.

    Aceder às instâncias de VM

  2. Se ainda não estiver selecionado, selecione o projeto que contém a instância a partir da qual quer eliminar um teste.

  3. Clique na instância a partir da qual quer eliminar um teste.

  4. Em Interfaces de rede, selecione a interface de rede a partir da qual quer eliminar um teste.

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

  6. Selecione a caixa de verificação à esquerda de um ou mais testes que quer eliminar.

  7. 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 origem
  • TEST_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 criado
  • TEST_ID: o ID do objeto Connectivity Tests (teste) que está a eliminar

O que se segue?