שאילתה ב-Cloud Number Registry

תצוגה מקדימה

השימוש במוצר הזה כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, שמפורטים בחלק "תנאים כלליים לשירות" בתנאים הספציפיים של השירות. השימוש במוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

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

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

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

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

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

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

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

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

חיפוש טווחי כתובות IP בחינם בטווחי כתובות IP שזוהו

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

• יכול להיות שהתוצאות יכללו כתובות שלא ניתן להשתמש בהן בטווחים של רשתות משנה ב-IPv4 וכתובות שלא ניתן להשתמש בהן בטווחים של רשתות משנה ב-IPv6.

• התוצאות עשויות לכלול כתובות IP זמניות שמוקצות למכונות שמופסקות.

המסוף

1. פותחים את הדף Cloud Number Registry במסוף Google Cloud .

   כניסה ל-Cloud Number Registry

2. לוחצים על הכרטיסייה ספרי רישום.

3. לוחצים על ספר רישום.

4. לוחצים על הכרטיסייה תחומים שזוהו.

5. לוחצים על תחום שהתגלה, ואז לוחצים על טווח שהתגלה בתוך התחום הזה.

6. לוחצים על חיפוש טווחי כתובות IP פנויים.

7. בקטע אורך הקידומת, בוחרים את גודל הטווח שרוצים למצוא.

   מוצגת רשימה של הטווחים הזמינים בגודל שצוין.

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 שבשימוש יש טווח מותאם אישית תואם.

המסוף

1. פותחים את הדף Cloud Number Registry במסוף Google Cloud .

   כניסה ל-Cloud Number Registry

2. לוחצים על הכרטיסייה ספרי רישום.

3. לוחצים על ספר רישום.

4. לוחצים על הכרטיסייה תחומים מותאמים אישית.

5. לוחצים על תחום מותאם אישית, ואז לוחצים על טווח מותאם אישית בתוך התחום הזה.

6. לוחצים על חיפוש טווחי כתובות IP פנויים.

7. בקטע אורך הקידומת, בוחרים את גודל הטווח שרוצים למצוא.

   מוצגת רשימה של הטווחים הזמינים בגודל שצוין.

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 בספר רישום.

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

• כתובת IP: כתובת ה-IP לחיפוש – לדוגמה, 10.10.10.46.
• ‫Realm: שם התחום לחיפוש – לדוגמה, vpc-global-123456789.
• טווח אב: ה-URI של טווח האב שרוצים לחפש בתוכו. לדוגמה: projects/project3/locations/global/customRanges/range7.
• גרסת IP: גרסת ה-IP שלפיה רוצים לסנן.

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

  • סינון לפי טקסט: טקסט המאפיין לחיפוש בטווחים – לדוגמה, europe-west1.
  • סינון לפי מפתחות וערכים: מפתח המאפיין והערך שלפיו רוצים לסנן – לדוגמה, המפתח addressType עם הערך INTERNAL.

המסוף

1. פותחים את הדף Cloud Number Registry במסוף Google Cloud .

   כניסה ל-Cloud Number Registry

2. לוחצים על הכרטיסייה ספרי רישום.

3. לוחצים על ספר רישום.

4. לוחצים על הכרטיסייה חיפוש לפי כתובת IP.

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

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

gcloud

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

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

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

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

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

• ‫REGISTRY_BOOK: השם של ספר הרישום שרוצים לחפש בו.
• ‫QUERY: השאילתה לחיפוש – לדוגמה:
  • "ip_address=\"2001:db8::/64\""
  • "attribute_text=europe-west1"
  • "attribute:(resourceName=projects/project123/regions/us-east1/subnetworks/subnet1)"
  • "realm=vpc-global-123456789"
  • "realm=vpc-global-123456789 AND ip_address=10.10.10.46"
  • "realm=vpc-global-123456789 AND ip_version=IPV6"
  • "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"
  • "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)"