ניהול Cloud Routers

במסמך הזה מוסבר איך להציג רשימה של Cloud Router, לעדכן אותם, לקבל את הסטטוס שלהם ולמחוק אותם.

לפני שמתחילים

gcloud

כדי להשתמש בדוגמאות של שורת הפקודה במדריך הזה:

  1. מתקינים או מעדכנים את הגרסה האחרונה של Google Cloud CLI.
  2. מגדירים אזור ותחום ברירת מחדל.

API

כדי להשתמש בדוגמאות ל-API במדריך הזה, צריך להגדיר גישה ל-API.

רשימת נתבי Cloud Router

כדי להציג רשימה של כל נתבי Cloud בפרויקט, מבצעים את השלבים הבאים.

המסוף

  1. נכנסים לדף Cloud Routers במסוף Google Cloud .

    מעבר אל Cloud Routers

  2. בדף Cloud Routers, מוצגת רשימה של נתבי Cloud Router.

gcloud

מריצים את הפקודה list. כדי להגביל את הרשימה לאזור אחד בלבד, מציינים --filter="region:(<var>REGION</var>).

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

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: המזהה של הפרויקט שרוצים להציג בו את נתבי Cloud
  • ‫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 Routers שלו.

כדי לראות רשימה של נתבי Cloud רק באזור ספציפי, משתמשים בשיטה routers.list:

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

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: המזהה של הפרויקט שרוצים להציג בו את נתבי Cloud
  • ‫REGION: האזור שבו רוצים להציג את נתבי Cloud

עדכון Cloud Routers

אם Cloud Router משויך ל-NCC Gateway, חשוב לזכור את הנקודות הבאות:

  • אי אפשר לעדכן את השדה 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
  • ‫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
  • ‫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
  • ‫REGION: האזור שבו נמצא Cloud Router
  • ‫ROUTER_NAME: השם של Cloud Router שרוצים לקבל את הסטטוס שלו

מחיקת Cloud Routers

לפני שמוחקים Cloud Router, צריך לוודא שהוא לא נמצא בשימוש של משאב אחר, כמו מנהרת Cloud VPN או צירוף ל-VLAN. כדי למחוק את Cloud Router, צריך למחוק קודם את המשאב המשויך. עם זאת, לא צריך להסיר את סשני ה-BGP לפני שמוחקים את Cloud Router.

כדי למחוק את Cloud Router, פועלים לפי השלבים הבאים.

המסוף

  1. נכנסים לדף Cloud Routers במסוף Google Cloud .

    מעבר אל Cloud Routers

  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 שרוצים למחוק

  • ‫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 שרוצים למחוק
  • ‫REGION: האזור שבו נמצא Cloud Router
  • ‫ROUTER_NAME: השם של Cloud Router

המאמרים הבאים

  • כדי לראות את ההגדרות של Cloud Router, את סשני ה-BGP שלו ואת הנתיבים ש-Cloud Router מפרסם, אפשר לעיין במאמר הצגת פרטים של נתב.
  • כדי לפתור בעיות בשימוש ב-Cloud Router, אפשר לעיין במאמר בנושא פתרון בעיות.