Cloud Router 관리

이 문서에서는 Cloud Router를 나열, 업데이트, 상태 확인, 삭제하는 방법을 설명합니다.

시작하기 전에

gcloud

이 가이드의 명령줄 예시를 사용하려면 다음을 수행하세요.

  1. 최신 버전의 Google Cloud CLI를 설치하거나 업데이트합니다.
  2. 기본 리전 및 영역을 설정합니다.

API

이 가이드의 API 예를 사용하려면 API 액세스를 설정합니다.

Cloud Router 나열

프로젝트의 모든 Cloud Router를 나열하려면 다음 단계를 수행합니다.

콘솔

  1. Trusted Cloud 콘솔에서 Cloud Routers 페이지로 이동합니다.

    Cloud Router로 이동

  2. Cloud Router 페이지에서 Cloud Router 목록을 봅니다.

gcloud

list 명령어를 실행합니다. 목록을 한 리전으로만 제한하려면 --filter="region:(<var>REGION</var>)을 지정합니다.

  gcloud compute routers list \
      --project=PROJECT_ID \
      [--filter="region:(REGION)]

다음을 바꿉니다.

  • PROJECT_ID: Cloud Router를 나열할 프로젝트의 ID
  • REGION: 라우터를 나열할 리전(예: asia-east1)

출력은 다음과 비슷합니다.

  NAME        REGION       NETWORK
  my-router   asia-east1   my-network

API

routers.aggregatedList 메서드를 사용합니다.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/routers

PROJECT_ID를 Cloud Router를 나열할 프로젝트의 ID로 바꿉니다.

특정 리전의 Cloud Router만 나열하려면 routers.list 메서드를 사용합니다.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers

다음을 바꿉니다.

  • PROJECT_ID: Cloud Router를 나열할 프로젝트의 ID
  • REGION: Cloud Router를 나열할 리전

Cloud Router 업데이트

Cloud Router가 NCC 게이트웨이와 연결된 경우 다음 사항에 유의하세요.

  • ncc_gateway 필드는 업데이트할 수 없습니다.
  • patch 또는 update 메서드는 요청 본문의 일부로 network 필드를 허용하지 않습니다.

gcloud

gcloud compute routers update 명령어를 사용합니다.

gcloud compute routers update ROUTER_NAME
    --region=REGION

다음을 바꿉니다.

  • ROUTER_NAME: 업데이트할 Cloud Router의 이름
  • REGION: Cloud Router가 있는 리전

API

routers.update 메서드를 사용합니다.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME

다음을 바꿉니다.

  • PROJECT_ID: Cloud Router를 나열할 프로젝트의 ID
  • REGION: Cloud Router가 있는 리전
  • ROUTER_NAME: 업데이트할 Cloud Router의 이름

Cloud Router 상태 가져오기

gcloud

gcloud compute routers get-status 명령어를 사용합니다.

gcloud compute routers get-status ROUTER_NAME \
    --project=PROJECT_ID \
    --region=REGION

다음을 바꿉니다.

  • ROUTER_NAME: 상태를 가져오려는 Cloud Router의 이름
  • PROJECT_ID: Cloud Router가 속한 프로젝트 ID
  • REGION: Cloud Router가 있는 리전

API

빈 요청 본문과 함께 routers.getRouterStatus 메서드를 사용합니다.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/getRouterStatus

다음을 바꿉니다.

  • PROJECT_ID: Cloud Router가 속한 프로젝트 ID
  • REGION: Cloud Router가 있는 리전
  • ROUTER_NAME: 상태를 가져오려는 Cloud Router의 이름

Cloud Router 삭제

Cloud Router를 삭제하기 전에 Cloud VPN 터널이나 VLAN 연결과 같은 다른 리소스에서 사용하고 있지 않은지 확인합니다. Cloud Router를 삭제하려면 먼저 관련 리소스를 삭제해야 합니다. 하지만 Cloud Router를 삭제하기 전에 BGP 세션을 삭제할 필요는 없습니다.

Cloud Router를 삭제하려면 다음 단계를 수행합니다.

콘솔

  1. Trusted Cloud 콘솔에서 Cloud Routers 페이지로 이동합니다.

    Cloud Router로 이동

  2. 삭제할 Cloud Router 옆의 체크박스를 선택합니다.

  3. 삭제를 클릭합니다.

gcloud

delete 명령어를 실행합니다. 삭제할 Cloud Router의 이름과 위치를 지정합니다.

gcloud compute routers delete ROUTER_NAME \
    --project=PROJECT_ID \
    --region=REGION

다음을 바꿉니다.

  • ROUTER_NAME: 삭제할 Cloud Router의 이름

  • PROJECT_ID: 삭제하려는 Cloud Router가 포함된 프로젝트의 ID

  • REGION: Cloud Router가 위치한 리전

출력은 다음과 비슷합니다.

Deleted [https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/asia-east1/routers/ROUTER_NAME].

API

routers.delete 메서드를 사용합니다.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME

다음을 바꿉니다.

  • PROJECT_ID: 삭제하려는 Cloud Router가 포함된 프로젝트의 ID
  • REGION: Cloud Router가 있는 리전
  • ROUTER_NAME: Cloud Router의 이름

다음 단계

  • Cloud Router 구성, BGP 세션, Cloud Router에서 공지하는 경로를 보려면 라우터 세부정보 보기를 참조하세요.
  • Cloud Router 사용 시 문제 해결을 참조하여 문제 해결하기