테스트 업데이트 또는 삭제

참고:참고: 연결 테스트는 VPC 네트워크에서 리소스 구성의 정적 분석을 수행합니다. 이 분석은 네트워크 데이터 평면의 실제 조건을 나타내지 않습니다.

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

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

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

시작하기 전에

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

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

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

     • Google API Client Library for Python Docs in GitHub, which includes installation and authentication instructions.
     • The Network Management API reference documentation for the API Python client.
5. Obtain the permissions that you need to run and view tests. For details, see Assign access.

테스트 업데이트

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

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

콘솔

기본 연결 테스트 페이지:

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

   연결 테스트로 이동

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

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

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

5. 저장을 클릭합니다.

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

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

1. Google Cloud 콘솔에서 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 필드를 업데이트합니다.

1개 이상의 테스트 삭제

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

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

콘솔

기본 연결 테스트 페이지:

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

   연결 테스트로 이동

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

3. Google Cloud 콘솔 페이지 상단에서 삭제를 클릭합니다.

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

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

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

1. Google Cloud 콘솔에서 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

다음 단계

• 구성 분석 상태
• 연결 테스트 문제 해결