שמירת כתובת IP פנימית סטטית

בדף הזה מוסבר איך להקצות ולנהל כתובות IPv4 או IPv6 פנימיות סטטיות ברשתות VPC.

כתובות IP פנימיות סטטיות מאפשרות לשמור כתובות IP פנימיות מטווח כתובות ה-IP שהוגדר בתת-הרשת, ואז להקצות את כתובות ה-IP הפנימיות השמורות האלה למשאבים לפי הצורך. כששומרים כתובת IP פנימית, הכתובת הזו יוצאת ממאגר ההקצאה הדינמית ואי אפשר להשתמש בה להקצאות אוטומטיות. כדי לשמור כתובות IP פנימיות סטטיות, נדרשות הרשאות ספציפיות של ניהול זהויות והרשאות גישה (IAM), כך שרק משתמשים מורשים יוכלו לשמור כתובת IP פנימית סטטית.

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

כדי לשמור כתובת IP חיצונית סטטית במקום כתובת IP פנימית, קראו את המאמר שמירת כתובות IP חיצוניות סטטיות.

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

  • מידע נוסף על כתובות IP
  • אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא התהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Google Cloud . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות בדרכים הבאות.

    צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:

    המסוף

    כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API של Google Cloud , לא צריך להגדיר אימות.

    gcloud

    התקינו את ה-CLI של Google Cloud. אחר כך, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

    gcloud init

    אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

    Terraform

    כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של Terraform שבדף הזה, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.

    1. התקינו את ה-CLI של Google Cloud.

    2. אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

    3. אם משתמשים במעטפת מקומית, צריך ליצור פרטי כניסה לאימות מקומי בחשבון המשתמש:

      gcloud auth application-default login

      אם אתם משתמשים ב-Cloud Shell, אתם לא צריכים לעשות את זה.

      אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

    למידע נוסף, ראו הגדרת ADC לסביבת פיתוח מקומית במאמרי העזרה בנושא אימות Google Cloud .

    REST

    כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

      התקינו את ה-CLI של Google Cloud.

      אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

    מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות לשמירה ולניהול של כתובות IP סטטיות, בקשו מהאדמין להקצות לכם בפרויקט את התפקיד אדמין רשת של Compute (roles/compute.networkAdmin) ב-IAM. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

זהו תפקיד שמוגדר מראש וכולל את ההרשאות שנדרשות כדי לשמור ולנהל כתובות IP סטטיות. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

כדי לשמור ולנהל כתובות IP סטטיות, נדרשות ההרשאות הבאות:

  • compute.addresses.create בכתובת ה-IP
  • compute.addresses.createInternal בכתובת ה-IP
  • compute.networks.list ברשת
  • compute.subnetworks.use ברשת המשנה
  • compute.subnetworks.list ברשת המשנה

יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

מגבלות

  • מספר כתובות ה-IP הפנימיות הסטטיות שאפשר לשמור לא יכול לחרוג מהמכסה של הפרויקט. מידע נוסף זמין בקטע מכסות לכל פרויקט במאמרי העזרה של VPC.

  • רק משאב אחד בכל פעם יכול להשתמש בכתובת IP פנימית סטטית.

  • אפשר לשמור כתובת IP פנימית סטטית רק ברשתות VPC. היא לא נתמכת ברשתות במצב מדור קודם.

  • מחיקת משאב לא משחררת באופן אוטומטי כתובת IP פנימית סטטית. צריך לשחרר באופן ידני כתובות IP פנימיות סטטיות כשלא צריכים אותן יותר.

  • לכל VM יכולים להיות כמה ממשקי רשת, ולכל ממשק אפשר להקצות את כתובות ה-IP הבאות בהתאם לסוג המחסנית:

    • ממשקים עם IPv4 בלבד:
      • כתובת IPv4 פנימית (חובה)
      • כתובת IPv4 חיצונית (אופציונלי)
    • ממשקים עם מחסנית כפולה (IPv4 ו-IPv6):
      • כתובת IPv4 פנימית (חובה)
      • כתובת IPv4 חיצונית (אופציונלי)
      • טווח כתובות IPv6 של /96, פנימי או חיצוני, אבל לא שניהם (חובה)
    • ממשקים מסוג IPv6 בלבד:
      • טווח כתובות IPv6 של /96, פנימי או חיצוני, אבל לא שניהם (חובה)
  • אי אפשר לבטל את ההקצאה או לשנות את הפרטים הבאים:

    • כתובת ה-IPv4 הפנימית של משאב קיים. לדוגמה, אי אפשר להקצות כתובת IP פנימית סטטית חדשה למכונה וירטואלית פועלת או למכונה וירטואלית שהופסקה.
    • כתובת ה-IPv6 הפנימית של מכונה וירטואלית עם ממשק רשת מסוג IPv6 בלבד.

    עם זאת, אתם יכולים לקדם כתובת IP פנימית זמנית של משאב לכתובת IP פנימית סטטית, כדי שהכתובת תישאר שמורה גם אחרי שהמשאב יימחק.

  • אי אפשר לשנות את השם של כתובת IP סטטית.

  • כתובות IP פנימיות סטטיות הן אזוריות, כלומר הן מוגבלות לאזור שבו הן שמורות. לדוגמה, אם יש כתובת IP פנימית סטטית שמורה ב-Region A, אפשר להשתמש בכתובת ה-IP רק ב-Region A.

שמירת כתובת IPv4 או IPv6 פנימית סטטית חדשה

כדי לשמור כתובת IP פנימית סטטית חדשה, צריך ליצור רשת VPC עם רשת משנה.

אם רוצים לשמור כתובת IPv6 פנימית סטטית ייחודית מקומית (ULA), ברשת ה-VPC צריך להיות טווח כתובות IPv6 פנימיות מסוג ULA. בנוסף, לרשת צריכה להיות רשת משנה עם טווח כתובות IPv6 וסוג הגישה INTERNAL ל-IPv6. מידע נוסף זמין במאמר מפרטים פנימיים של IPv6.

כדי לשמור כתובת IP פנימית נפרדת, מבצעים את השלבים הבאים.

המסוף

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

    לדף כתובות ה-IP

  2. לוחצים על Reserve internal static IP address. יכול להיות שתצטרכו ללחוץ על התפריט More actions כדי לראות את הכפתור הזה.
  3. בשדה Name, מזינים שם לכתובת ה-IP.
  4. ברשימה IP version, בוחרים את גרסת ה-IP הנדרשת:
    • כדי לשמור כתובת IPv4 פנימית סטטית, בוחרים באפשרות IPv4.
    • כדי לשמור כתובת IPv6 פנימית סטטית, בוחרים באפשרות IPv6.
  5. ברשימות Network ו-Subnetwork, בוחרים רשת VPC ורשת משנה, בהתאמה.
  6. מציינים איך רוצים לשמור את כתובת ה-IP:
    • בכתובות IPv4, כדי לציין כתובת IPv4 פנימית סטטית לשמירה, בשדה Static IP address בוחרים באפשרות Let me choose ומזינים כתובת IPv4 בהתאמה אישית. אחרת, המערכת מקצה באופן אוטומטי כתובת IPv4 פנימית סטטית ברשת המשנה.
    • בכתובות IPv6, כדי לציין טווח של כתובות IPv6 פנימיות סטטיות שרוצים לשמור, בשדה Static IPv6 range בוחרים באפשרות Let me choose ומזינים טווח של כתובות IPv6 מסוג /96 בהתאמה אישית מתוך טווח כתובות ה-IPv6 הפנימיות מסוג /64 של רשת המשנה. אחרת, המערכת מקצה באופן אוטומטי טווח כתובות IPv6 פנימיות סטטיות בתת-הרשת.
  7. אופציונלי: אם רוצים לשתף את כתובת ה-IPv4 הפנימית הסטטית בממשקי קצה שונים, בוחרים באפשרות Shared ברשימה Purpose. ברירת המחדל היא לא משותף.

  8. לוחצים על Reserve.

gcloud

  • כדי לשמור כתובת IPv4 פנימית, משתמשים בפקודה compute addresses create:

    gcloud compute addresses create ADDRESS_NAMES \
        --region REGION --subnet SUBNETWORK \
        --addresses IPV4_ADDRESS
    

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

    • ‫ADDRESS_NAMES: השמות של כתובות ה-[--purpose=SHARED_LOADBALANCER_VIP] שרוצים ליצור (לפחות אחת). אם יש כמה כתובות, צריך לציין את כולן ברשימה, ולהפריד ביניהן באמצעות רווחים – לדוגמה, example-address-1 example-address-2 example-address-3
    • ‫REGION: האזור של הבקשה.
    • ‫SUBNETWORK: רשת המשנה של כתובת ה-IP הפנימית הזו.
    • ‫IPV4_ADDRESS: כתובת ה-IP שרוצים לשמור, שצריכה להיות בטווח ה-IP הראשי של רשת המשנה. אם לא מציינים כתובת IP, המערכת מקצה אותה באופן אוטומטי מרשת המשנה.
  • כדי לשמור כתובת IPv6 פנימית, משתמשים בפקודה compute addresses create.

    • כדי להקצות באופן אוטומטי כתובת IPv6 פנימית מתת-רשת, מציינים את הערך IPV6 בדגל --ip-version:

      gcloud compute addresses create ADDRESS_NAMES \
          --region REGION --subnet SUBNETWORK \
          --ip-version IPV6
      
    • כדי לשמור כתובת IPv6 פנימית ספציפית מתת-רשת, מציינים את הדגל --addresses. אל תכללו את הדגל --ip-version:

      gcloud compute addresses create ADDRESS_NAMES \
          --region REGION --subnet SUBNETWORK \
          --addresses IPV6_ADDRESS
      

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

    • ‫ADDRESS_NAMES: השמות של הכתובות שרוצים לשמור (לפחות אחת). אם יש כמה כתובות, צריך לציין את כולן ברשימה שמופרדת ברווחים, לדוגמה: example-address-1 example-address-2 example-address-3
    • ‫REGION: האזור של הבקשה.
    • ‫SUBNETWORK: רשת המשנה של כתובת ה-IPv6 הפנימית הזו.
    • ‫IPV6_ADDRESS: כתובת ה-IP שרוצים לשמור. היא צריכה להיות כתובת IPv6 מסוג /96 מטווח כתובות ה-IPv6 הפנימיות /64 של רשת המשנה.

דוגמאות

  • שמירת כתובת IPv4 פנימית שהוקצתה אוטומטית מרשת משנה:

    gcloud compute addresses create example-address-1 \
        --region us-central1 \
        --subnet subnet-1
    
  • שמירת כתובת IPv4 פנימית ספציפית מתת-רשת:

    gcloud compute addresses create example-address-1 \
        --region us-central1 \
        --subnet subnet-1 \
        --addresses 10.128.0.12
    
  • שמירת כתובת IPv6 פנימית סטטית מתת-רשת:

    gcloud compute addresses create example-address-1 \
        --region us-central1 \
        --subnet subnet-1 \
        --ip-version IPV6
    
  • כדי ליצור כמה כתובות IPv4, מעבירים יותר משם אחד של כתובת IPv4. כל הכתובות שמורות באותה רשת משנה:

    gcloud compute addresses create example-address-1 example-address-2 \
        --region us-central1 \
        --subnet subnet-1 \
        --addresses 10.128.0.12,10.128.0.13
    

Terraform

אתם יכולים להשתמש במודול של Terraform כדי ליצור כתובת IP פנימית.

בדוגמה הבאה, הארגומנטים של Terraform מכילים ערכים לדוגמה שאפשר לשנות. בדוגמה הזו נוצרות שתי כתובות IP פנימיות ספציפיות:

module "address" {
  source     = "terraform-google-modules/address/google"
  version    = "~> 4.0"
  project_id = var.project_id # Replace this with your project ID in quotes
  region     = "asia-east1"
  subnetwork = "my-subnet"
  names      = ["internal-address1", "internal-address2"]
  addresses  = ["10.0.0.3", "10.0.0.4"]
}

בדוגמה הבאה נוצרות שתי כתובות IP פנימיות שמוקצות באופן דינמי:

module "address" {
  source     = "terraform-google-modules/address/google"
  version    = "~> 4.0"
  project_id = var.project_id # Replace this with your project ID in quotes
  region     = "asia-east1"
  subnetwork = "my-subnet"
  names      = ["internal-address1", "internal-address2"]
}

API

משתמשים בשיטה addresses.insert:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses

בכתובות IPv4 ו-IPv6, גוף הבקשה צריך לכלול את השדה addressType, שצריך להיות INTERNAL, את name הכתובת ואת subnetwork שאליו שייכת כתובת ה-IP. גוף הבקשה יכול לכלול את purpose של כתובת ה-IP הפנימית.

אתם יכולים לאפשר למערכת להקצות לכם כתובת IP באופן אוטומטי, או להשתמש ב-address כדי לציין כתובת IP פנימית. כתובת IPv4 שאתם שומרים חייבת להיות שייכת לטווח הראשי של כתובות IPv4 של רשת המשנה. כתובת IPv6 שאתם שומרים חייבת להיות שייכת לטווח כתובות ה-IPv6 הפנימיות של רשת המשנה.

{
  "addressType": "INTERNAL",
  "name": "IPV4_ADDRESS_NAME",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK",
  "address": "IPV4_ADDRESS",
  "purpose": "GCE_ENDPOINT"
}

לדוגמה:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
{
  "addressType": "INTERNAL",
  "name": "example-ipv4-address-1",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet",
  "address": "10.128.0.12",
  "purpose": "GCE_ENDPOINT"
}

לכתובות IPv6 פנימיות, צריך לציין גם את ipVersion בתור IPV6.

{
  "addressType": "INTERNAL",
  "name": "IPV6_ADDRESS_NAME",
  "ipVersion": "IPV6",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK",
  "address": "IPV6_ADDRESS",
  "purpose": "GCE_ENDPOINT"
}

לדוגמה:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
{
  "addressType": "INTERNAL",
  "name": "example-ipv6-address-1",
  "ipVersion": "IPV6",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet",
  "address": "2001:db8:a0b:c0d:e0f:f0e::",
  "purpose": "GCE_ENDPOINT"
}

שמירת טווח של כתובות IP פנימיות סטטיות ל-HA VPN over Cloud Interconnect

אתם יכולים לשמור טווח של כתובות IP פנימיות סטטיות לשימוש עם HA VPN over Cloud Interconnect.

כשיוצרים את כתובת ה-IP הפנימית הסטטית, צריך לציין את הדגל --purpose=IPSEC_INTERCONNECT ואורך קידומת (--prefix-length) בין 26 ל-29.

כתובות ה-IPv4 הפנימיות האזוריות שאתם שומרים חלות על שערי ה-HA VPN שמשמשים את Cloud Interconnect.

מידע נוסף זמין במאמר הקצאת טווחים של כתובות IP פנימיות לשערי HA VPN.

איך בודקים אם כתובת IPv4 או IPv6 פנימית היא זמנית או סטטית

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

באופן כללי, כתובת IP זמנית משתחררת אם עוצרים או מוחקים את המשאב.

כדי לבדוק אם כתובת היא סטטית או זמנית:

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

    לדף כתובות ה-IP

  2. מאתרים את הכתובת ברשימה ובודקים את סוג כתובת ה-IP בעמודה Type.

הפיכת כתובת IPv4 או IPv6 פנימית וזמנית שנמצאת בשימוש לכתובת סטטית

אם יש לכם כתובות IP פנימיות זמניות שנמצאות בשימוש, אתם יכולים לקדם אותן לכתובות IP פנימיות סטטיות כדי שהן יישארו בפרויקט עד שתסירו אותן באופן פעיל.

כדי להפוך כתובת IP פנימית זמנית לכתובת IP פנימית סטטית:

המסוף

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

    לדף כתובות ה-IP

  2. לוחצים על כתובות IP פנימיות.
  3. אופציונלי: בשדה Filter, כדי לחפש כתובות IP זמניות, מזינים ephemeral ובוחרים באפשרות Ephermal : Type מהרשימה הנפתחת.
  4. בוחרים את כתובת ה-IP הפנימית שרוצים לקדם.
  5. בתפריט More actions () שבסוף שורת התצוגה של כתובת ה-IP שנבחרה, בוחרים באפשרות Promote to static IP address.
  6. מזינים שם לכתובת ה-IP הסטטית החדשה ולוחצים על Reserve.

gcloud

  1. כדי להפוך כתובת IPv6 פנימית זמנית קיימת לכתובת קבועה, צריך לדעת מה הערך של כתובת ה-IP הזו. משתמשים ב-Google Cloud CLI כדי לשלוח בקשת describe למשאב ולקבל את הערך של כתובת ה-IP.

    • למכונה עם כתובת IPv4, משתמשים בפקודה הבאה:

      gcloud compute instances describe INSTANCE_NAME --zone ZONE | grep "networkIP"
      
    • למכונה עם כתובת IPv6, משתמשים בפקודה הבאה:

      gcloud compute instances describe INSTANCE_NAME --zone ZONE | grep "ipv6Address"
      
    • לכלל העברה אזורי, משתמשים בפקודה הבאה:

      gcloud compute forwarding-rules describe FORWARDING_RULE_NAME --region REGION | grep "IPAddress"
      

      לכלל העברה גלובלי, משתמשים בדגל --global במקום בדגל --region.

  2. לקדם את הכתובת:

    • כדי לקדם כתובת IPv4 פנימית קיימת אחת או יותר, משתמשים בפקודה compute addresses create ומציינים בדגל --addresses את כתובות ה-IP הפנימיות המפורשות שרוצים לקדם:

      gcloud compute addresses create IPV4_ADDRESS_NAMES \
        --addresses IPV4_ADDRESSES \
        --region REGION \
        --prefix-length PREFIX_LENGTH \
        --subnet SUBNETWORK
      

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

      • ‫IPV4_ADDRESS_NAMES: השמות של כתובות ה-IPv4. אם יש כמה כתובות, צריך לציין את כל שמות הכתובות ברשימה, עם רווחים ביניהן, לדוגמה: example-address-name-1 example-address-name-2 example-address-name-3. מצהירים על השמות באותו סדר שבו מצהירים על כתובות ה-IP. לדוגמה, נניח שציינתם את שמות הכתובות בתור example-address-name-1 example-address-name-2 example-address-name-3 ואת כתובות ה-IPv4 בתור 192.0.2.0 192.0.2.1 192.0.2.2. בתרחיש הזה, Compute Engine ממפה את השמות והכתובות באופן הבא:

        • example-address-name-1: 192.0.2.0
        • example-address-name-2: ‏192.0.2.1
        • example-address-name-3: 192.0.2.2
      • ‫IPV4_ADDRESSES: כתובות ה-IPv4 שרוצים לקדם. אם יש כמה כתובות, צריך לציין את כולן ברשימה שמופרדת ברווחים, לדוגמה: 192.0.2.0 192.0.2.1 192.0.2.2.

      • ‫REGION: האזור שבו רוצים לשמור את הכתובת.

      • ‫PREFIX_LENGTH: אופציונלי. אורך הקידומת של טווח כתובות ה-IPv4. הערך צריך להיות מספר שלם בין 7 ל-31. צריך לכלול את השדה הזה רק אם מציינים טווח כתובות. אם כתובת ה-IPv4 שצוינה היא כתובת IP אחת, אל תכללו את השדה.

      • ‫SUBNETWORK: רשת המשנה של הבקשה הזו.

    • כדי לקדם כתובת IPv6 פנימית קיימת אחת או יותר, משתמשים בפקודה compute addresses create ומציינים את הדגל --addresses עם כתובות ה-IPv6 הפנימיות המפורשות:

      gcloud compute addresses create IPV6_ADDRESS_NAMES \
       --addresses IPV6_ADDRESSES \
       --region REGION \
       --prefix-length PREFIX_LENGTH \
       --subnet SUBNETWORK
      

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

      • ‫IPV6_ADDRESS_NAMES: שמות הכתובת. מצהירים על השמות באותו סדר שבו מצהירים על כתובות ה-IPv6. במקרה הזה, IPV6_ADDRESS_NAME_1 תואם ל-IPV6_ADDRESS_1 ו-IPV6_ADDRESS_NAME_2 תואם ל-IPV6_ADDRESS_2.
      • ‫IPV6_ADDRESS_1,[IPV6_ADDRESS_2,...]: כתובות ה-IPv6 שרוצים לקדם בפורמט CIDR.
      • ‫PREFIX_LENGTH_1,[PREFIX_LENGTH_2,...]: אורך הקידומת של כתובות IPv6.
      • ‫REGION: האזור שבו רוצים לשמור את הכתובת.
      • ‫SUBNETWORK: רשת המשנה של הבקשה הזו.

      כתובת ה-IPv6 הפנימית נשארת מחוברת למכונה הקיימת גם אחרי שהיא הופכת לכתובת IPv6 פנימית סטטית. אם אתם צריכים להקצות את כתובת ה-IPv6 הפנימית הסטטית ששודרגה למשאב אחר, קודם צריך לבטל את ההקצאה של כתובת ה-IPv6 הפנימית הסטטית מהמכונה הקיימת.

API

משתמשים בשיטה addresses.insert:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses

בכתובות IPv4 ו-IPv6, גוף הבקשה חייב לכלול את addressType, שצריך להיות INTERNAL, את name של הכתובת, את address לקידום ואת subnetwork שכתובת ה-IP שייכת לו. בכתובות IPv6, גוף הבקשה צריך לכלול גם את prefixLength עם הערך 96.

  • גוף הבקשה לקידום כתובות IPv4 פנימיות:

    {
    "name": "ADDRESS_NAME",
    "addressType": "INTERNAL",
    "address": "IP_ADDRESS",
    "subnetwork": "regions/REGION/subnetworks/SUBNETWORK"
    }
    

    לדוגמה:

    POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
    {
    "name": "example-IPv4-address-1",
    "addressType": "INTERNAL",
    "address": "10.128.0.2",
    "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet"
    }
    
  • גוף הבקשה לקידום כתובות IPv6 פנימיות:

    {
    "name": "ADDRESS_NAME",
    "addressType": "INTERNAL",
    "address": "IP_ADDRESS",
    "subnetwork": "regions/REGION/subnetworks/SUBNETWORK",
    "prefixLength": 96
    }
    

    לדוגמה:

    POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
    {
    "name": "example-IPv6-address-1",
    "addressType": "INTERNAL",
    "address": "fd20:0:0::",
    "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet",
    "prefixLength": 96
    }
    

שימוש בכתובת IPv4 או IPv6 פנימית סטטית עם VPC משותף

אתם יכולים ליצור כתובת IP פנימית סטטית שמורה ברשת משנה משותפת של רשת VPC משותפת. אובייקט כתובת ה-IP עצמו נוצר באותו פרויקט שירות כמו המשאב שישתמש בו, למרות שהערך שלו מגיע מהטווח של כתובות ה-IP הזמינות ברשת המשנה המשותפת שנבחרה ברשת ה-VPC המשותפת. למידע נוסף על תרחיש השימוש הזה, עיינו במקורות המידע הבאים:

הצגת רשימה של כתובות IPv4 או IPv6 פנימיות סטטיות

כדי לראות את כל כתובות ה-IP הפנימיות הסטטיות הקיימות:

המסוף

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

    לדף כתובות ה-IP

  2. לוחצים על כתובות IP פנימיות.

gcloud

משתמשים בפקודה gcloud compute addresses list:

gcloud compute addresses list

API

משתמשים ב-method addresses.list:

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

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

  • ‫PROJECT_ID: מזהה הפרויקט של הבקשה הזו
  • ‫REGION: שם האזור של הבקשה הזו

כדי להציג את כל הכתובות בכל האזורים, משתמשים ב-method‏ addresses.aggregatedList:

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

שחרור כתובת IPv4 או IPv6 פנימית סטטית

אם אתם לא צריכים יותר כתובת IP פנימית סטטית, אתם יכולים לשחרר את כתובת ה-IP על ידי מחיקת המשאב של כתובת ה-IP.

אם אתם משתמשים במסוף Google Cloud , אתם יכולים לשחרר כתובת IP סטטית רק אם היא לא נמצאת בשימוש של משאב אחר.

אם אתם משתמשים ב-CLI של gcloud או ב-API, אתם יכולים לשחרר כתובת IP גם אם היא בשימוש של משאב אחר.

  • אם כתובת ה-IP לא נמצאת בשימוש על ידי משאב, היא מוחזרת למאגר של כתובות ה-IP הפנימיות הזמינות.

  • אם כתובת ה-IP נמצאת בשימוש על ידי משאב, היא נשארת מחוברת למשאב עד שהמשאב נמחק.

כדי לשחרר כתובת IPv4 או IPv6 פנימית סטטית, מבצעים את השלבים הבאים.

המסוף

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

    לדף כתובות ה-IP

  2. לוחצים על הכרטיסייה כתובות IP פנימיות.
  3. אופציונלי: בשדה Filter, מזינים static ובוחרים באפשרות Static : Type מהרשימה הנפתחת.
  4. בוחרים את כתובת ה-IP הפנימית הסטטית שרוצים לשחרר.
  5. לוחצים על Release static address, ואז מאשרים את הפעולה בלחיצה על Release בתיבת הדו-שיח.

    אם האפשרות הזו לא מופיעה, לוחצים על התפריט More actions () בסרגל התפריטים העליון ובוחרים ברשימה את האפשרות Release static address.

gcloud

משתמשים בפקודה compute addresses delete:

gcloud compute addresses delete ADDRESS_NAME \
    --region REGION

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

  • ‫ADDRESS_NAME: שם הכתובת שרוצים למחוק.
  • ‫REGION: האזור שאליו שייכת הכתובת.

לדוגמה:

gcloud compute addresses delete example-address-to-delete \
    --region us-west1

API

משתמשים בשיטה addresses.delete:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME

בדוגמה הזו מוחקים כתובת באזור us-west1:

DELETE https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-west1/addresses/example-address-to-delete

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