연결 테스트 업데이트 또는 삭제

이 페이지의 단계에 따라 연결 테스트를 수정하거나 삭제하는 방법을 알아보세요. 개발자 또는 다른 사용자가 만든 테스트를 수정하거나 삭제할 수 있습니다.

테스트를 생성, 확인, 재실행하려면 연결 테스트 만들기 및 실행을 확인하세요.

연결 테스트에 대한 자세한 내용은 개요를 참조하세요.

시작하기 전에

연결 테스트를 사용하려면 먼저 Google Cloud에서 다음 항목을 설정하세요.

  1. Google Cloud Console에서 프로젝트 선택기 페이지로 이동합니다.

    프로젝트 선택기로 이동

    Google Cloud 프로젝트를 선택하거나 만듭니다.

  2. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.
  3. Cloud SDK의 일부인 gcloud 명령줄 도구를 설치합니다. 최신 버전의 gcloud 도구를 설치하려면 Cloud SDK 문서를 참조하세요.

    전체 명령어 목록은 gcloud명령어 참조를 확인하세요.

  4. Network Management API를 사용 설정합니다. API를 사용 설정하면 다음과 같은 이점이 있습니다.

    • Network Management API를 사용하는 API 호출 예시

      API 탐색기를 사용하여 Network Management API 명령어를 테스트할 수 있습니다. Network Management API 참조 문서에서 Try this API 열을 사용하여 API 필드를 탐색하고 테스트를 실행합니다.

    • API Python 클라이언트를 사용하는 샘플 코드

      이 코드 예시에서는 Network Management API와 상호작용하기 위해 api라는 리소스를 구성했다고 가정합니다. 리소스를 구성하려면 build 함수를 사용합니다. 아래 예시를 참조하세요.

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

      API Python 클라이언트에 대한 자세한 내용은 다음을 참조하세요.

  5. 테스트를 실행하고 보는 데 필요한 권한을 가져옵니다. 자세한 내용은 액세스 할당을 참조하세요.

테스트 업데이트

이 섹션의 단계에 따라 테스트를 업데이트합니다. 테스트의 name을 제외한 모든 필드를 변경할 수 있습니다.

작업 실행 중에 update 테스트 작업 상태를 확인하려면 실행 중인 테스트 작업 확인을 참조하세요.

콘솔

기본 연결 테스트 페이지에서

  1. Google Cloud Console에서 연결 테스트 페이지로 이동합니다.

    연결 테스트로 이동

  2. 테스트를 업데이트하려면 테스트 이름을 클릭합니다.

  3. 연결 테스트 세부정보 페이지에서 페이지 상단에 있는 수정 을 클릭합니다.

  4. 테스트 옵션을 수정합니다.

  5. 저장을 클릭합니다.

    테스트가 자동으로 다시 실행됩니다.

네트워크 인터페이스 세부정보 페이지에서

  1. Google Cloud Console에서 VM 인스턴스 페이지로 이동합니다.

    VM 인스턴스로 이동

  2. 테스트를 업데이트할 인스턴스가 포함된 프로젝트를 선택하지 않았으면 해당 프로젝트를 선택합니다.

  3. 테스트를 업데이트할 인스턴스를 클릭합니다.

  4. 네트워크 인터페이스에서 테스트를 업데이트할 네트워크 인터페이스를 선택합니다.

  5. 네트워크 분석에서 연결 테스트를 클릭합니다.

  6. 업데이트할 테스트의 이름을 클릭합니다.

  7. 연결 테스트 세부정보 페이지에서 페이지 상단에 있는 수정 을 클릭합니다.

  8. 테스트 옵션을 수정합니다.

  9. 저장을 클릭합니다.

    테스트가 자동으로 다시 실행됩니다.

gcloud

테스트를 업데이트하려면 업데이트하려는 테스트 ID와 변경하려는 명령어 옵션을 사용하여 다음 명령어를 입력합니다. 다음 예시에서는 대상 IP 주소를 변경합니다.

  gcloud network-management connectivity-tests update NAME \
    --destination-ip-address= DESTINATION_IP_ADDRESS

다음 값을 바꿉니다.

  • NAME: 연결 테스트 이름
  • DESTINATION_IP_ADDRESS: 테스트할 내부 또는 외부 대상 IP 주소. IPv6 주소는 테스트 대상이 전역 부하 분산기 VIP인 경우에만 허용됩니다.

API

networkmanagement.connectivitytests.patch 메서드를 사용하여 테스트를 업데이트(수정)합니다.

  PATCH https: //networkmanagement.googleapis.com/v1/{resource.name=projects/PROJECT_ID/locations/global/connectivityTests/TEST_ID}
    {
      "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "projectId": "SOURCE_PROJECT",
      },
    }

다음 값을 바꿉니다.

  • PROJECT_ID: 소스 VM의 프로젝트 ID
  • TEST_ID: 실행 중인 연결 테스트 객체(테스트)의 ID
  • SOURCE_IP_ADDRESS: 테스트할 내부 또는 외부 소스 IP 주소. IPv6 주소는 테스트 대상이 전역 부하 분산기 VIP인 경우에만 허용됩니다.
  • SOURCE_PROJECT: 소스 엔드포인트의 프로젝트 ID

Python

다음 예시 코드는 테스트의 소스 IP 주소를 업데이트합니다. 자세한 내용은 API Python 클라이언트 참조 문서의 patch를 참조하세요.

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

다음 값을 바꿉니다.

  • PROJECT_ID: 테스트가 생성된 프로젝트의 프로젝트 ID
  • TEST_ID: 실행 중인 연결 테스트 객체(테스트)의 ID
  • SOURCE_IP_ADDRESS: 테스트를 시행하는 내부 또는 외부 소스 IP 주소. IPv6 주소는 테스트 대상이 전역 부하 분산기 VIP인 경우에만 허용됩니다.

updateMask는 패치가 업데이트하는 필드를 지정하는 필수 매개변수입니다. 이 예시에서는 source 필드를 업데이트합니다.

하나 이상의 테스트 삭제하기

이 섹션의 단계에 따라 테스트를 삭제합니다.

작업 실행 중에 delete 테스트 작업 상태를 확인하려면 실행 중인 테스트 작업 확인을 참조하세요.

콘솔

기본 연결 테스트 페이지에서

  1. Google Cloud Console에서 연결 테스트 페이지로 이동합니다.

    연결 테스트로 이동

  2. 삭제할 1개 이상의 테스트 왼쪽에 있는 확인란을 클릭합니다.

  3. Cloud Console 페이지 상단에 있는 삭제 를 클릭합니다.

연결 테스트 세부정보 페이지에서

  1. 기본 연결 테스트 페이지에서 테스트 이름을 클릭합니다.
  2. 연결 테스트 세부정보 페이지 상단에 있는 삭제 를 클릭합니다.

네트워크 인터페이스 세부정보 페이지에서

  1. Google Cloud Console에서 VM 인스턴스 페이지로 이동합니다.

    VM 인스턴스로 이동

  2. 테스트를 삭제할 인스턴스가 포함된 프로젝트를 이미 선택하지 않은 경우, 해당 프로젝트를 선택합니다.

  3. 테스트를 삭제하려는 인스턴스를 클릭합니다.

  4. 네트워크 인터페이스에서 테스트를 삭제할 네트워크 인터페이스를 선택합니다.

  5. 네트워크 분석에서 연결 테스트를 클릭합니다.

  6. 삭제할 테스트 왼쪽에 있는 체크박스를 한 개 이상 선택합니다.

  7. 테스트 목록 상단에 있는 삭제 를 클릭합니다.

gcloud

테스트를 삭제하려면 다음 명령을 입력합니다. 삭제하려는 테스트의 테스트 ID를 사용합니다.

  gcloud beta network-management connectivity-tests delete NAME

NAME을 연결 테스트 이름으로 바꿉니다.

API

테스트를 삭제하려면 networkmanagement.connectivitytests.delete 메서드를 사용합니다.

DELETE https://networkmanagement.googleapis.com/v1/{name=projects/PROJECT_ID/locations/global/connectivityTests/{TEST_ID}

다음 값을 바꿉니다.

  • PROJECT_ID: 소스 VM의 프로젝트 ID
  • TEST_ID: 실행 중인 연결 테스트 객체(테스트)의 ID

Python

다음 예시 코드는 테스트를 삭제합니다. 자세한 내용은 API Python 클라이언트 참조 문서의 delete을 참조하세요.

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

다음 값을 바꿉니다.

  • PROJECT_ID: 테스트가 생성된 프로젝트의 프로젝트 ID
  • TEST_ID: 삭제할 연결 테스트 객체(테스트)의 ID

다음 단계