Atualizando ou excluindo testes de conectividade

Aprenda a editar ou excluir testes de conectividade, seguindo as etapas nesta página. Você pode editar ou excluir testes criados por você e por outras pessoas.

Para criar, exibir ou executar novamente testes, leia Executando testes de conectividade.

Para saber mais sobre testes de conectividade, leia a Visão geral.

Antes de começar

Configure os seguintes itens no Google Cloud antes de usar o Connectivity Tests:

  1. No Console do Google Cloud, acesse a página do seletor de projetos.

    Acessar a página do seletor de projetos

  2. Selecione ou crie um projeto do Google Cloud.
  3. Verifique se o faturamento está ativado para seu projeto em nuvem.

Os procedimentos neste documento incluem o seguinte:

  • Exemplos de chamadas de API que usam a API Network Management. Para saber mais informações, consulte a documentação da API.

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

Como usar o cliente Python da API

O código de exemplo neste documento presume que você criou um recurso chamado api para interagir com a API Network Management. Para criar um recurso, use a função build.

Veja o exemplo a seguir:

 from googleapiclient.discovery import build

 api = build('networkmanagement', 'v1')

Para ver mais informações, consulte os seguintes tópicos:

Usar o API Explorer

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

Como usar o SDK do gcloud

A ferramenta de linha de comando gcloud faz parte do SDK do Cloud. Para instalar a versão mais recente da ferramenta de linha de comando gcloud, consulte a documentação do SDK do Cloud.

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

Como verificar uma operação de teste em execução

Para verificar o status de uma operação de teste enquanto a operação é executada, consulte Como verificar uma operação de teste em execução.

Alguns exemplos de operações de teste são update e delete.

Como atualizar um teste

Siga as etapas nesta seção para atualizar um teste. Você pode alterar qualquer campo, exceto o name do teste.

Console

Na página principal de testes de conectividade

  1. No Console do Google Cloud, acesse a página Testes de conectividade.

    Acesse a página Connectivity Tests

  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 de teste.
  5. Clique em Save.

    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.

    Acessar a página "Instâncias de VM"

  2. Se ainda não estiver selecionado, selecione o projeto que contém a instância em que você quer atualizar um teste.
  3. Clique na instância em que você quer atualizar um teste.
  4. Em Interfaces de rede, selecione a interface de rede 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 de teste.
  9. 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 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 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 criado
  • TEST_ID: o ID do objeto de teste de conectividade (teste) que você está executando
  • SOURCE_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.

Como excluir um ou mais testes

Console

Na página principal de testes de conectividade

  1. No Console do Google Cloud, acesse a página Testes de conectividade.

    Acesse a página Connectivity Tests

  2. Clique na caixa de seleção à esquerda de um ou mais testes para excluir.
  3. Na parte superior da página do Console do Cloud, clique em Excluir .

Na página de detalhes do teste de conectividade

  1. Na página principal 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.

    Acessar a página "Instâncias de VM"

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

  3. Clique na instância da qual você quer excluir um teste.

  4. Em Interfaces de rede, selecione a interface de rede de qual 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ê quer 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 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 criado
  • TEST_ID: o ID do objeto de teste de conectividade (teste) que você está excluindo

A seguir