Atualizar ou excluir 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, visualizar ou executar novamente testes, leia Criar e executar Testes de conectividade.

Para saber mais sobre o Connectivity Tests, consulte a visão geral.

Antes de começar

Antes de usar o Connectivity Tests, configure os seguintes itens no Google Cloud:

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

    Acessar o seletor de projetos

    Selecione ou crie um projeto do Google Cloud.

  2. Verifique se o faturamento está ativado no seu projeto do Google Cloud.
  3. Instale a ferramenta de linha de comando gcloud, que faz parte do SDK do Cloud. Para instalar a versão mais recente da ferramenta gcloud, consulte a documentação do SDK do Cloud.

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

  4. Ativar a API Network Management. A ativação da API 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 da API Python.

      Com o código de exemplo, presumimos que você tenha criado 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 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 de teste update durante a execução, consulte Verificar uma operação de teste em execução.

Console

Na página principal de testes de conectividade

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

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

Excluir um ou mais testes

Siga as etapas nesta seção para excluir um teste.

Para verificar o status da operação de teste delete durante a execução, consulte Verificar uma operação de teste em execução.

Console

Na página principal de testes de conectividade

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

    Acesse Testes de conectividade

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