הגדרת פרויקט לשימוש ב-Cloud Number Registry

בדף הזה מוסבר איך להגדיר פרויקט לשימוש בCloud Number Registry. רק פרויקט אחד בכל ארגון יכול להשתמש ב-Cloud Number Registry. כדי להגדיר את Cloud Number Registry, מנהל הארגון צריך ליצור org-number-registriesמשאב כדי לקבוע באיזה פרויקט אפשר להשתמש.

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

  1. בוחרים פרויקט קיים או יוצרים פרויקט חדש לניהול של Cloud Number Registry בארגון האב. מומלץ מאוד ליצור פרויקט ייעודי למטרה הזו. מידע נוסף זמין במאמר הגדרת פרויקט עבור Cloud Number Registry.
    1. נכנסים לדף לבחירת הפרויקט במסוף Google Cloud .

      כניסה לדף לבחירת הפרויקט

    2. בוחרים או יוצרים Google Cloud פרויקט.

      תפקידים שנדרשים כדי לבחור או ליצור פרויקט

      • Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
      • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים
  2. מפעילים את Cloud Number Registry API, אם הוא עדיין לא מופעל.

    תפקידים שנדרשים להפעלת ממשקי API

    כדי להפעיל ממשקי API, נדרשת ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק Service Usage' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

    להפעלת ה-API

  3. מוודאים שיש את ההרשאות הנדרשות כדי להשלים את ההדרכה.

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

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

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

אופציונלי: בדיקה אם Cloud Number Registry מוגדר

רק פרויקט אחד בכל ארגון יכול להגדיר את Cloud Number Registry. אתם יכולים לבדוק אם Cloud Number Registry כבר מוגדר בארגון מכל פרויקט בארגון.

המסוף

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

    כניסה ל-Cloud Number Registry

    • אם Cloud Number Registry כבר מוגדר בארגון הזה, תועברו אוטומטית לפרויקט שמנהל את Cloud Number Registry.
    • אם לא הוגדר Cloud Number Registry לארגון, מוצג לחצן יצירת היקף אדמין.

gcloud

בודקים אם Cloud Number Registry כבר מוגדר בארגון באמצעות הפקודה gcloud alpha number-registry ipam-admin-scopes check-availability.

  • אם Cloud Number Registry כבר מוגדר, התגובה היא UNAVAILABLE.
  • אם אין הגדרה קיימת, התשובה היא AVAILABLE.
gcloud alpha number-registry ipam-admin-scopes check-availability \
    --scopes=organizations/ORGANIZATION_ID \
    --location=global

מחליפים את ORGANIZATION_ID במספר המזהה של הארגון שרוצים לנהל.

הגדרת פרויקט לשימוש ב-Cloud Number Registry

כדי להגדיר פרויקט לשימוש ב-Cloud Number Registry, צריך ליצור org-number-registries משאב שמגדיר איזה פרויקט יכול לשמש להגדרת Cloud Number Registry עבור ארגון האב שלו.

כשמגדירים את Cloud Number Registry,‏Google Cloud בודק שיוצרים את היקף האדמין של IPAM בפרויקט שתואם לפרויקט שהוגדר במשאב org-number-registries.

המסוף

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

    כניסה ל-Cloud Number Registry

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

  3. בחלונית Manage designated project (ניהול הפרויקט המיועד), בשדה Admin project (פרויקט אדמין), לוחצים על Select (בחירה) ובוחרים את הפרויקט שרוצים להשתמש בו עבור Cloud Number Registry.

  4. לוחצים על הגדרת פרויקט.

gcloud

מגדירים פרויקט לשימוש ב-Cloud Number Registry באמצעות הפקודה gcloud alpha number-registry org-number-registries create.

gcloud alpha number-registry org-number-registries create ORG_NUMBER_REGISTRY \
    --admin-project=projects/PROJECT_ID \
    --target-scopes=organizations/ORGANIZATION_ID \
    --organization=ORGANIZATION_ID \
    --location=global

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

  • ‫ORG_NUMBER_REGISTRY: שם של משאב רישום מספרי הארגון.
  • ‫PROJECT_ID: מספר המזהה של הפרויקט שבו רוצים להשתמש כדי לאחסן את המידע של Cloud Number Registry.
  • ‫ORGANIZATION_ID: מספר המזהה של הארגון שרוצים לנהל.

הצגה של ייעודי פרויקטים

אפשר לראות איזה פרויקט הוגדר לשימוש ב-Cloud Number Registry.

המסוף

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

    כניסה ל-Cloud Number Registry

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

  3. בחלונית Manage designated project (ניהול הפרויקט המיועד), בודקים את השדה Admin project (פרויקט לניהול).

gcloud

  • כדי לראות את רשימת ייעודי הפרויקט ב-Cloud Number Registry, משתמשים בפקודה gcloud alpha number-registry org-number-registries list.

    gcloud alpha number-registry org-number-registries list \
        --organization=ORGANIZATION_ID \
        --location=global
    

    מחליפים את ORGANIZATION_ID במספר המזהה של הארגון שמנהלים.

  • כדי לראות את הפרטים של ייעוד פרויקט ב-Cloud Number Registry, משתמשים בפקודה gcloud alpha number-registry org-number-registries describe.

    gcloud alpha number-registry org-number-registries describe ORG_NUMBER_REGISTRY \
        --organization=ORGANIZATION_ID \
        --location=global
    

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

    • ‫ORG_NUMBER_REGISTRY: השם של משאב רישום מספרי הארגון.
    • ‫ORGANIZATION_ID: המספר המזהה של הארגון שאתם מנהלים.

מחיקת ייעוד פרויקט

אם יש ייעוד לפרויקט, אבל לא הגדרתם את Cloud Number Registry בפרויקט, אתם יכולים למחוק את משאב org-number-registries שמייעד את הפרויקט.

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

המסוף

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

    כניסה ל-Cloud Number Registry

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

  3. בחלונית Manage designated project (ניהול הפרויקט המיועד), לוחצים על Remove project designation (הסרת ייעוד הפרויקט).

gcloud

כדי למחוק ייעוד של פרויקט, משתמשים בפקודה gcloud alpha number-registry org-number-registries delete.

gcloud alpha number-registry org-number-registries delete ORG_NUMBER_REGISTRY \
    --organization=ORGANIZATION_ID \
    --location=global

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

  • ‫ORG_NUMBER_REGISTRY: השם של משאב רישום מספרי הארגון.
  • ‫ORGANIZATION_ID: מספר המזהה של הארגון שאתם מנהלים.

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