שאילתה ב-Cloud Number Registry

בדף הזה מוסבר איך לשלוח שאילתות לגבי מידע שמאוחסן במאגר מספרי הטלפון ב-Cloud.

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

  1. הגדרה של Cloud Number Registry
  2. בוחרים את הפרויקט בארגון שהוגדר לספק גישה ל-Cloud Number Registry.
  3. מוודאים שיש את ההרשאות הנדרשות כדי להשלים את ההדרכה.

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

כדי לקבל את ההרשאות שדרושות לצפייה במידע שמאוחסן ב-Cloud Number Registry, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ Cloud Number Registry IPAM Viewer (roles/cloudnumberregistry.ipamViewer) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

הצגת ניצול כתובות ה-IP

אפשר לראות את ניצול כתובות ה-IP בטווחים שזוהו או בטווחים בהתאמה אישית.

הצגת נתוני השימוש בטווח שזוהה

gcloud

כדי להציג את השימוש בטווח שזוהה, משתמשים בפקודה gcloud alpha number-registry discovered-ranges show-utilization.

gcloud alpha number-registry discovered-ranges show-utilization DISCOVERED_RANGE_NAME \
    --location=global

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

  • ‫DISCOVERED_RANGE_NAME: השם של הטווח שזוהה.

הצגת ניצול של טווח מותאם אישית

gcloud

כדי להציג את מידת הניצול של טווח מותאם אישית, משתמשים בפקודה gcloud alpha number-registry custom-ranges show-utilization.

gcloud alpha number-registry custom-ranges show-utilization CUSTOM_RANGE_NAME \
    --location=global

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

  • ‫CUSTOM_RANGE_NAME: השם של הטווח המותאם אישית.

איך מוצאים טווחי כתובות IP בחינם

אפשר למצוא טווחי כתובות IP זמינים בתוך טווחים שזוהו או טווחים מותאמים אישית.

חיפוש טווחי כתובות IP בחינם בטווחי כתובות IP שנמצאו

כשמגלים טווחי כתובות IP פנויים בטווחי כתובות IP שזוהו, חלות המגבלות הבאות:

gcloud

כדי למצוא טווחי כתובות IP בחינם בטווחי כתובות IP שזוהו, משתמשים בפקודה gcloud alpha number-registry discovered-ranges find-free-ip-ranges.

gcloud alpha number-registry discovered-ranges find-free-ip-ranges DISCOVERED_RANGE_NAME \
    --cidr-prefix-length=PREFIX_LENGTH \
    --range-count=RANGE_COUNT \
    --location=global

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

  • ‫DISCOVERED_RANGE_NAME: השם של הטווח שזוהה.
  • ‫PREFIX_LENGTH: אורך הקידומת של טווח ה-CIDR שרוצים למצוא. אפשר להשתמש ב-32 כדי למצוא כתובות IPv4 נפרדות.
  • ‫RANGE_COUNT: מספר הטווחים הפנויים שרוצים למצוא.

חיפוש טווחים של כתובות IP בחינם בטווחים בהתאמה אישית

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

gcloud

כדי למצוא טווחי כתובות IP פנויים בטווחי כתובות IP בהתאמה אישית, משתמשים בפקודה gcloud alpha number-registry custom-ranges find-free-ip-ranges.

gcloud alpha number-registry custom-ranges find-free-ip-ranges CUSTOM_RANGE_NAME \
    --cidr-prefix-length=PREFIX_LENGTH \
    --range-count=RANGE_COUNT \
    --location=global

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

  • ‫CUSTOM_RANGE_NAME: השם של הטווח המותאם אישית.
  • ‫PREFIX_LENGTH: אורך הקידומת של טווח ה-CIDR שרוצים למצוא. אפשר להשתמש ב-32 כדי למצוא כתובות IPv4 נפרדות.
  • ‫RANGE_COUNT: מספר הטווחים הפנויים שרוצים למצוא.

חיפוש מקורות מידע על כתובות IP

אפשר לחפש משאבי כתובות IP בספר רישום.

אפשר להשתמש במסננים הבאים בשאילתות:

  • ‫realm: שם התחום שבו רוצים לחפש – לדוגמה, prod-realm-5.
  • ‫parent_range: ה-URI של טווח האב שרוצים לחפש בתוכו, לדוגמה projects/project3/locations/global/customRanges/range7.
  • ‫ip_address: כתובת ה-IP לחיפוש – לדוגמה, 10.10.10.46.
  • ‫ip_version: גרסת ה-IP שלפיה יתבצע הסינון.
  • ‫attribute_text: טקסט המאפיין לחיפוש בטווחים – לדוגמה, production.
  • ‫attribute: מפתח המאפיין והערך שלפיו רוצים לסנן, לדוגמה, attribute:(environment=production).

אפשר לשלב בין מסננים בדרכים הבאות:

  • אפשר לשלב שני מסננים או יותר באותה שאילתה באמצעות AND.
  • אפשר להשתמש ב-AND NOT בשילוב עם המסנן attribute:(KEY=VALUE) בלבד.

  • אפשר להשתמש ב-attribute או ב-attribute_text בשאילתה מסוימת, אבל לא בשניהם.

gcloud

מחפשים משאבי IP באמצעות הפקודה gcloud alpha number-registry registry-books search-ip-resources.

gcloud alpha number-registry registry-books search-ip-resources REGISTRY_BOOK \
    --query=QUERY \
    --show-utilization \
    --location=global

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

  • ‫REGISTRY_BOOK: השם של ספר הרישום שרוצים לחפש בו.
  • ‫QUERY: השאילתה לחיפוש – לדוגמה:
    • "attribute:(resourceName=projects/project123/regions/us-east1/subnetworks/subnet1)"
    • "realm=vpc-global-123456789 AND ip_address=10.10.10.46"
    • "realm=vpc-global-123456789 AND ip_version=IPV6"
    • "ip_address=\"2001:db8::/64\""
    • "realm=vpc-global-123456789 AND attribute_text=production"
    • "realm=vpc-global-123456789 AND attribute:(team=\"Sales Europe\")"
    • "parent_range=projects/project3/locations/global/customRanges/range7 AND attribute:(team=marketing)"
    • "parent_range=projects/project3/locations/global/customRanges/range7 AND NOT attribute:(environment=production)"