ניהול של כמה משאבים בארגון

כמה משאבי Google Cloud ארגון מאפשרים לכם לנהל יחידות עסקיות או מחלקות כישויות מבודדות ללא ניהול מרכזי. ברוב המקרים, כדאי להשתמש בתיקיות מתחת למשאב ארגון אחד בהיררכיית המשאבים שלGoogle Cloud . משאב הארגון קובע את הבעלות על הפרויקטים והתיקיות שמתחתיו. כל חשבון Google Workspace או Cloud Identity ממופה לדומיין ראשי, כמו example.com, ויוצר משאב ארגון אחד. למידע נוסף על אפשרויות של דומיינים לזהויות, קראו את המאמרים הוספת דומיין חלופי או דומיין משני של משתמש ושינוי הדומיין הראשי ב-Google Workspace. לחלופין, אתם יכולים להשתמש בארגונים עצמאיים שפועלים באופן עצמאי ולא דורשים חשבון Cloud Identity או Google Workspace.

ההשפעות של שימוש בכמה משאבי ארגון

כדאי להשתמש בכמה משאבי ארגון כשאתם לא רוצים שמשתמשים מחשבון Google Cloud, Google Workspace או Cloud Identity אחד יוכלו לגשת למשאבים שנוצרו על ידי משתמשים מחשבון אחר. הפרדת המשאבים לכמה משאבי ארגון גורמת לדברים הבאים:

  • כברירת מחדל, לאף משתמש אין הרשאות גישה מרכזיות ושליטה בכל המשאבים.

  • צריך לשכפל כללי מדיניות שמשותפים לארגוני משנה בכל משאב של ארגון.

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

  • לכל משאב ארגוני ב-Cloud Identity נדרש חשבון Google Workspace. כדי להפעיל כמה משאבי ארגון ב-Cloud Identity, צריך כמה חשבונות Google Workspace ויכולת לנהל את הזהויות בכל החשבונות האלה.

שימוש במשאב ארגוני אחד

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

בחירת אדמין ארגוני

משתמשי Google Workspace ו-Cloud Identity יכולים לבחור משתמש אחד או יותר שישמשו כאדמינים של IAM ברמת הארגון במשאב הארגון, לפי ההוראות הבאות.

במאמר הוספת בעלים של ארגון מוסבר איך מגדירים את IAM לארגונים עצמאיים.

כדי להוסיף אדמין ארגוני, אתם יכולים להשתמש במסוף Google Cloud , ב-Google Cloud CLI או ב-Resource Manager API.

המסוף

  1. נכנסים למסוף Google Cloud כסופר-אדמין ב-Google Workspace או ב-Cloud Identity, ועוברים לדף IAM & Admin:

    פתיחת הדף "IAM וניהול"

  2. בוחרים את משאב הארגון שרוצים לערוך:

    1. לוחצים על הרשימה הנפתחת של הפרויקטים בחלק העליון של הדף.

    2. בתיבת הדו-שיח Select from, לוחצים על הרשימה הנפתחת של הארגון ובוחרים את המשאב הארגוני שאליו רוצים להוסיף את התפקיד Organization Administrator.

    3. ברשימה שמופיעה, לוחצים על משאב הארגון כדי לפתוח את הדף IAM Permissions שלו.

  3. לוחצים על Add ומזינים את כתובת האימייל של המשתמשים שרוצים להגדיר כמנהלי הארגון.

  4. ברשימה הנפתחת Select a role, בוחרים באפשרות Resource Manager > Organization Administrator, ואז לוחצים על Save.

    האדמין הארגוני יכול:

    • שליטה מלאה במשאב הארגון. הפרדת תחומי האחריות בין סופר-אדמין ב-Google Workspace או ב-Cloud Identity לבין אדמין ב- Google Cloud.

    • להקצות תפקידים רלוונטיים ב-IAM כדי להאציל סמכויות על פונקציות קריטיות.

gcloud

כדי להוסיף את התפקיד "Organization Administrator", מריצים את הפקודה gcloud organizations add-iam-policy-binding:

gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
    --member="user:EMAIL_ADDRESS" \
    --role="roles/resourcemanager.organizationAdmin"

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

  • ‫ORGANIZATION_ID: המזהה הייחודי של משאב הארגון.
  • ‫EMAIL_ADDRESS: כתובת האימייל של המשתמש שרוצים להוסיף כמנהל חשבון ארגוני.

API

כדי להוסיף Organization Administrator, צריך להפעיל את ה-method‏ setIamPolicy במשאב הארגון.

  1. מציגים את מדיניות ה-IAM הנוכחית של משאב הארגון:

    POST https://cloudresourcemanager.googleapis.com/v3/organizations/ORGANIZATION_ID:getIamPolicy
    
  2. מעדכנים את המדיניות שמוחזרת כדי להוסיף את החבר לתפקיד roles/resourcemanager.organizationAdmin.

  3. מגדירים את המדיניות המעודכנת:

    POST https://cloudresourcemanager.googleapis.com/v3/organizations/ORGANIZATION_ID:setIamPolicy
    {
      "policy": {
        "bindings": [
          {
            "role": "roles/resourcemanager.organizationAdmin",
            "members": [
              "user:EMAIL_ADDRESS"
            ]
          }
        ],
        "etag": "ETAG_VALUE"
      }
    }
    

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

    • ‫ORGANIZATION_ID: המזהה הייחודי של משאב הארגון.
    • ‫EMAIL_ADDRESS: כתובת האימייל של המשתמש שרוצים להוסיף כמנהל ארגון.
    • ‫ETAG_VALUE: הערך של etag מהמדיניות שהוחזרה בשלב הראשון.

יצירת תיקיות לארגוני משנה

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

כדי ליצור תיקיות, צריך להיות לכם התפקיד Folder Admin או יוצר תיקיות ברמת ההורה. לדוגמה, כדי ליצור תיקיות ברמת הארגון, צריך להיות לכם אחד מהתפקידים האלה ברמת הארגון.

כשיוצרים תיקייה, צריך לתת לה שם. שמות התיקיות צריכים לעמוד בדרישות הבאות:

  • השם יכול להכיל אותיות, ספרות, רווחים, מקפים וקווים תחתונים.
  • השם המוצג של התיקייה חייב להתחיל ולהסתיים באות או בספרה.
  • השם צריך להיות באורך של 3 עד 30 תווים.
  • השם צריך להיות שונה מכל התיקיות האחרות שמשותפות לאותה תיקיית הורה.

כדי ליצור תיקייה:

המסוף

כדי ליצור תיקיות, מבצעים את הפעולות הבאות:

  1. נכנסים לדף Manage resources במסוף Google Cloud :

    פתיחת הדף Manage resources

  2. לוחצים על יצירת תיקייה ובוחרים באחת מהאפשרויות הבאות:

    • תיקייה רגילה ב-Google Cloud: משאב תיקייה רגיל.
    • תיקייה תואמת: תיקיית Assured Workloads, שמספקת אמצעי בקרה נוספים על משאבי Google Cloud בהתאם לרגולציה, לאזור או לריבונות. אם תבחרו באפשרות הזו, תועברו אל Assured Workloads כדי ליצור תיקייה.
  3. בתיבה שם התיקייה, מזינים את השם של התיקייה החדשה.

  4. בקטע Parent resource, לוחצים על Browse ובוחרים את משאב הארגון או התיקייה שבהם רוצים ליצור את התיקייה החדשה.

    1. לוחצים על יצירה.

gcloud

אפשר ליצור תיקיות באופן פרוגרמטי באמצעות Google Cloud CLI.

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

gcloud resource-manager folders create \
   --display-name=DISPLAY_NAME \
   --organization=ORGANIZATION_ID

כדי ליצור תיקייה שההורה שלה הוא תיקייה אחרת:

gcloud resource-manager folders create \
   --display-name=DISPLAY_NAME \
   --folder=FOLDER_ID

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

  • ‫DISPLAY_NAME: השם המוצג של התיקייה. לשתי תיקיות עם אותו הורה לא יכול להיות אותו שם לתצוגה. השם המוצג חייב להתחיל ולהסתיים באות או בספרה, יכול להכיל אותיות, ספרות, רווחים, מקפים וקווים תחתונים, ולא יכול להיות ארוך מ-30 תווים.
  • ‫ORGANIZATION_ID: המזהה של משאב הארגון ההורה, אם ההורה הוא משאב ארגון.
  • ‫FOLDER_ID: המזהה של תיקיית ההורה, אם ההורה הוא תיקייה.

API

אפשר ליצור תיקיות באמצעות בקשת API.

בקשת ה-JSON:

request_json= '{
  display_name: DISPLAY_NAME,
  parent: ORGANIZATION_NAME
}'

בקשת ה-curl ליצירת תיקייה:

curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/folders

כאשר:

  • ‫DISPLAY_NAME: השם המוצג של התיקייה החדשה, לדוגמה "My Awesome Folder".
  • ‫ORGANIZATION_NAME: השם של משאב הארגון שבו יוצרים את התיקייה, לדוגמה organizations/123.

התגובה של Create Folder:

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

{
  "name": "operations/fc.123456789",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "CREATE"
  }
}

בקשת ה-curl של Get Operation:

curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fc.123456789

התגובה של Get Operation:

{
  "name": "operations/fc.123456789",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "CREATE"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.Folder",
    "name": "folders/12345",
    "parent": "organizations/123",
    "displayName": "DISPLAY_NAME",
    "lifecycleState": "ACTIVE",
    "createTime": "2017-07-19T23:29:26.018Z",
    "updateTime": "2017-07-19T23:29:26.046Z"
  }
}

הקצאת תפקידי אדמין בתיקיות

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

כדי להגדיר גישה לתיקיות, צריך להיות לכם התפקיד אדמין IAM של תיקיות או אדמין תיקיות ברמת ההורה.

המסוף

  1. במסוף Google Cloud , פותחים את הדף Manage Resources.

    פתיחת הדף Manage Resources

  2. לוחצים על הרשימה הנפתחת Organization בפינה השמאלית העליונה ובוחרים את המשאב הארגוני.

  3. מסמנים את התיבה לצד הפרויקט שרוצים לשנות את ההרשאות שלו.

    1. ב-Info panel שבצד ימין, בקטע Permissions, מזינים את כתובות האימייל של החברים שרוצים להוסיף.

    2. ברשימה הנפתחת Select a role, בוחרים את התפקיד שרוצים להקצות לחברים האלה.

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

gcloud

אפשר להגדיר גישה לתיקיות באופן פרוגרמטי באמצעות Google Cloud CLI או ה-API בארכיטקטורת REST.

gcloud resource-manager folders \
    add-iam-policy-binding FOLDER_ID \
    --member=user:email1@example.com \
    --role=roles/resourcemanager.folderEditor
gcloud resource-manager folders \
    add-iam-policy-binding FOLDER_ID \
    --member=user:email1@example.com \
    --role=roles/resourcemanager.folderViewer

לחלופין:

gcloud resource-manager folders \
    set-iam-policy FOLDER_ID POLICY_FILE

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

  • ‫FOLDER_ID: המזהה של התיקייה החדשה
  • ‫POLICY_FILE: הנתיב לקובץ המדיניות של התיקייה

API

השיטה setIamPolicy מגדירה את מדיניות בקרת הגישה בתיקייה, ומחליפה כל מדיניות קיימת. השדה resource צריך להיות שם המשאב של התיקייה, לדוגמה folders/1234.

 request_json= '{
   policy: {
     version: "1",
     bindings: [
       {
         role: "roles/resourcemanager.folderEditor",
         members: [
           "user:email1@example.com",
           "user:email2@example.com",
         ]
       }
     ]
   }
 }'

בקשת ה-curl:

   curl -X POST -H "Content-Type: application/json" \
   -H "Authorization: Bearer ${bearer_token}" \
   -d "$request_json" \
   https://cloudresourcemanager.googleapis.com/v3/FOLDER_ID:setIamPolicy

מחליפים את FOLDER_ID בשם התיקייה שמגדירים לה את מדיניות ה-IAM, לדוגמה folders/123.

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

כל Folder Admin יכול להגביל את התפקיד Project Creator לחברים בארגון המשנה שלו. הם יכולים גם להסיר את הדומיין מהתפקיד יצירת פרויקטים במדיניות ההרשאות של משאב הארגון.

לסופר-אדמינים ב-Google Workspace יש הרשאות אדמין ארגוני שלא ניתן לבטל. בדרך כלל, הסופר-אדמינים האלה מנהלים את הזהויות ואת כללי המדיניות של הזהויות, ולא את המשאבים ואת כללי המדיניות של המשאבים ב- Google Cloud .

המסוף

כדי להסיר את התפקידים שמוקצים למשתמשים כברירת מחדל באמצעות מסוף Google Cloud :

  1. נכנסים לדף Manage resources במסוף Google Cloud :

    פתיחת הדף Manage resources

  2. לוחצים על הרשימה הנפתחת Organization בחלק העליון של הדף ובוחרים את המשאב הארגוני.

  3. מסמנים את תיבת הסימון של משאב הארגון שרוצים לשנות את ההרשאות שלו. אם אין לכם משאב תיקייה, משאב הארגון לא יהיה גלוי. כדי להמשיך, קראו את ההוראות לביטול תפקידים בדף IAM.

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

  5. ברשימת התפקידים המורחבת, לוחצים על סמל ההסרה לצד חשבון המשתמש שרוצים להסיר מהתפקיד. צילום מסך של ממשק המשתמש

  6. בתיבת הדו-שיח Remove principal?‎ שמופיעה, לוחצים על Remove כדי לאשר את הסרת התפקיד מהחשבון הראשי שצוין.

  7. חוזרים על שני השלבים שלמעלה לכל תפקיד שרוצים להסיר.

דוגמה

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

דיאגרמה של ההיררכיה

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

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

בחירת אדמין ארגוני

בוחרים משתמש אחד או יותר שישמשו כאדמינים של IAM ברמת הארגון במשאב הארגון.

כדי להוסיף אדמין ארגוני, אתם יכולים להשתמש במסוף Google Cloud , ב-Google Cloud CLI או ב-Resource Manager API.

המסוף

  1. נכנסים למסוף Google Cloud כסופר-אדמין ב-Google Workspace או ב-Cloud Identity, ועוברים לדף IAM & Admin:

    פתיחת הדף "IAM וניהול"

  2. בוחרים את משאב הארגון שרוצים לערוך:

    1. לוחצים על הרשימה הנפתחת של הפרויקטים בחלק העליון של הדף.

    2. בתיבת הדו-שיח Select from, לוחצים על הרשימה הנפתחת של הארגון ובוחרים את המשאב הארגוני שאליו רוצים להוסיף את התפקיד Organization Administrator.

    3. ברשימה שמופיעה, לוחצים על משאב הארגון כדי לפתוח את הדף IAM Permissions שלו.

  3. לוחצים על Add ומזינים את כתובת האימייל של המשתמשים שרוצים להגדיר כמנהלי הארגון.

  4. ברשימה הנפתחת Select a role, בוחרים באפשרות Resource Manager > Organization Administrator, ואז לוחצים על Save.

    האדמין הארגוני יכול:

    • שליטה מלאה במשאב הארגון. הפרדת תחומי האחריות בין סופר-אדמין ב-Google Workspace או ב-Cloud Identity לבין אדמין ב- Google Cloud.

    • להקצות תפקידים רלוונטיים ב-IAM כדי להאציל סמכויות על פונקציות קריטיות.

gcloud

כדי להוסיף את התפקיד "Organization Administrator", מריצים את הפקודה gcloud organizations add-iam-policy-binding:

gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
    --member="user:EMAIL_ADDRESS" \
    --role="roles/resourcemanager.organizationAdmin"

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

  • ‫ORGANIZATION_ID: המזהה הייחודי של משאב הארגון.
  • ‫EMAIL_ADDRESS: כתובת האימייל של המשתמש שרוצים להוסיף כמנהל חשבון ארגוני.

API

כדי להוסיף Organization Administrator, צריך להפעיל את ה-method‏ setIamPolicy במשאב הארגון.

  1. מציגים את מדיניות ה-IAM הנוכחית של משאב הארגון:

    POST https://cloudresourcemanager.googleapis.com/v3/organizations/ORGANIZATION_ID:getIamPolicy
    
  2. מעדכנים את המדיניות שמוחזרת כדי להוסיף את החבר לתפקיד roles/resourcemanager.organizationAdmin.

  3. מגדירים את המדיניות המעודכנת:

    POST https://cloudresourcemanager.googleapis.com/v3/organizations/ORGANIZATION_ID:setIamPolicy
    {
      "policy": {
        "bindings": [
          {
            "role": "roles/resourcemanager.organizationAdmin",
            "members": [
              "user:EMAIL_ADDRESS"
            ]
          }
        ],
        "etag": "ETAG_VALUE"
      }
    }
    

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

    • ‫ORGANIZATION_ID: המזהה הייחודי של משאב הארגון.
    • ‫EMAIL_ADDRESS: כתובת האימייל של המשתמש שרוצים להוסיף כמנהל ארגון.
    • ‫ETAG_VALUE: הערך של etag מהמדיניות שהוחזרה בשלב הראשון.

הסרת התפקיד "יצירת פרויקטים"

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

המסוף

כדי להסיר את התפקידים שמוקצים למשתמשים כברירת מחדל באמצעות מסוף Google Cloud :

  1. נכנסים לדף Manage resources במסוף Google Cloud :

    פתיחת הדף Manage resources

  2. לוחצים על הרשימה הנפתחת Organization בחלק העליון של הדף ובוחרים את המשאב הארגוני.

  3. מסמנים את תיבת הסימון של משאב הארגון שרוצים לשנות את ההרשאות שלו. אם אין לכם משאב תיקייה, משאב הארגון לא יהיה גלוי. כדי להמשיך, קראו את ההוראות לביטול תפקידים בדף IAM.

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

  5. ברשימת התפקידים המורחבת, לוחצים על סמל ההסרה לצד חשבון המשתמש שרוצים להסיר מהתפקיד. צילום מסך של ממשק המשתמש

  6. בתיבת הדו-שיח Remove principal?‎ שמופיעה, לוחצים על Remove כדי לאשר את הסרת התפקיד מהחשבון הראשי שצוין.

  7. חוזרים על שני השלבים שלמעלה לכל תפקיד שרוצים להסיר.

יצירת תיקיות לחשבונות Google Workspace

יוצרים תיקייה מתחת למשאב הארגון לכל חשבון Google Workspace.

כדי ליצור תיקיות, צריך להיות לכם התפקיד Folder Admin או יוצר תיקיות ברמת ההורה. לדוגמה, כדי ליצור תיקיות ברמת הארגון, צריך להיות לכם אחד מהתפקידים האלה ברמת הארגון.

כשיוצרים תיקייה, צריך לתת לה שם. שמות התיקיות צריכים לעמוד בדרישות הבאות:

  • השם יכול להכיל אותיות, ספרות, רווחים, מקפים וקווים תחתונים.
  • השם המוצג של התיקייה חייב להתחיל ולהסתיים באות או בספרה.
  • השם צריך להיות באורך של 3 עד 30 תווים.
  • השם צריך להיות שונה מכל התיקיות האחרות שמשותפות לאותה תיקיית הורה.

כדי ליצור תיקייה:

המסוף

כדי ליצור תיקיות, מבצעים את הפעולות הבאות:

  1. נכנסים לדף Manage resources במסוף Google Cloud :

    פתיחת הדף Manage resources

  2. לוחצים על יצירת תיקייה ובוחרים באחת מהאפשרויות הבאות:

    • תיקייה רגילה ב-Google Cloud: משאב תיקייה רגיל.
    • תיקייה תואמת: תיקיית Assured Workloads, שמספקת אמצעי בקרה נוספים על משאבי Google Cloud בהתאם לרגולציה, לאזור או לריבונות. אם תבחרו באפשרות הזו, תועברו אל Assured Workloads כדי ליצור תיקייה.
  3. בתיבה שם התיקייה, מזינים את השם של התיקייה החדשה.

  4. בקטע Parent resource, לוחצים על Browse ובוחרים את משאב הארגון או התיקייה שבהם רוצים ליצור את התיקייה החדשה.

    1. לוחצים על יצירה.

gcloud

אפשר ליצור תיקיות באופן פרוגרמטי באמצעות Google Cloud CLI.

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

gcloud resource-manager folders create \
   --display-name=DISPLAY_NAME \
   --organization=ORGANIZATION_ID

כדי ליצור תיקייה שההורה שלה הוא תיקייה אחרת:

gcloud resource-manager folders create \
   --display-name=DISPLAY_NAME \
   --folder=FOLDER_ID

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

  • ‫DISPLAY_NAME: השם המוצג של התיקייה. לשתי תיקיות עם אותו הורה לא יכול להיות אותו שם לתצוגה. השם המוצג חייב להתחיל ולהסתיים באות או בספרה, יכול להכיל אותיות, ספרות, רווחים, מקפים וקווים תחתונים, ולא יכול להיות ארוך מ-30 תווים.
  • ‫ORGANIZATION_ID: המזהה של משאב הארגון ההורה, אם ההורה הוא משאב ארגון.
  • ‫FOLDER_ID: המזהה של תיקיית ההורה, אם ההורה הוא תיקייה.

API

אפשר ליצור תיקיות באמצעות בקשת API.

בקשת ה-JSON:

request_json= '{
  display_name: DISPLAY_NAME,
  parent: ORGANIZATION_NAME
}'

בקשת ה-curl ליצירת תיקייה:

curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/folders

כאשר:

  • ‫DISPLAY_NAME: השם המוצג של התיקייה החדשה, לדוגמה "My Awesome Folder".
  • ‫ORGANIZATION_NAME: השם של משאב הארגון שבו יוצרים את התיקייה, לדוגמה organizations/123.

התגובה של Create Folder:

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

{
  "name": "operations/fc.123456789",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "CREATE"
  }
}

בקשת ה-curl של Get Operation:

curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fc.123456789

התגובה של Get Operation:

{
  "name": "operations/fc.123456789",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "CREATE"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.Folder",
    "name": "folders/12345",
    "parent": "organizations/123",
    "displayName": "DISPLAY_NAME",
    "lifecycleState": "ACTIVE",
    "createTime": "2017-07-19T23:29:26.018Z",
    "updateTime": "2017-07-19T23:29:26.046Z"
  }
}

הקצאת תפקידי אדמין בתיקיות

בכל אחת מהתיקיות שנוצרו, מקצים למשתמש אחד או יותר את התפקיד Folder Admin. המשתמשים האלה מקבלים הרשאות אדמין לתיקייה ולארגון המשנה שהיא מייצגת.

כדי להגדיר גישה לתיקיות, צריך להיות לכם התפקיד אדמין IAM של תיקיות או אדמין תיקיות ברמת ההורה.

המסוף

  1. במסוף Google Cloud , פותחים את הדף Manage Resources.

    פתיחת הדף Manage Resources

  2. לוחצים על הרשימה הנפתחת Organization בפינה השמאלית העליונה ובוחרים את המשאב הארגוני.

  3. מסמנים את התיבה לצד הפרויקט שרוצים לשנות את ההרשאות שלו.

    1. ב-Info panel שבצד ימין, בקטע Permissions, מזינים את כתובות האימייל של החברים שרוצים להוסיף.

    2. ברשימה הנפתחת Select a role, בוחרים את התפקיד שרוצים להקצות לחברים האלה.

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

gcloud

אפשר להגדיר גישה לתיקיות באופן פרוגרמטי באמצעות Google Cloud CLI או ה-API בארכיטקטורת REST.

gcloud resource-manager folders \
    add-iam-policy-binding FOLDER_ID \
    --member=user:email1@example.com \
    --role=roles/resourcemanager.folderEditor
gcloud resource-manager folders \
    add-iam-policy-binding FOLDER_ID \
    --member=user:email1@example.com \
    --role=roles/resourcemanager.folderViewer

לחלופין:

gcloud resource-manager folders \
    set-iam-policy FOLDER_ID POLICY_FILE

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

  • ‫FOLDER_ID: המזהה של התיקייה החדשה
  • ‫POLICY_FILE: הנתיב לקובץ המדיניות של התיקייה

API

השיטה setIamPolicy מגדירה את מדיניות בקרת הגישה בתיקייה, ומחליפה כל מדיניות קיימת. השדה resource צריך להיות שם המשאב של התיקייה, לדוגמה folders/1234.

 request_json= '{
   policy: {
     version: "1",
     bindings: [
       {
         role: "roles/resourcemanager.folderEditor",
         members: [
           "user:email1@example.com",
           "user:email2@example.com",
         ]
       }
     ]
   }
 }'

בקשת ה-curl:

   curl -X POST -H "Content-Type: application/json" \
   -H "Authorization: Bearer ${bearer_token}" \
   -d "$request_json" \
   https://cloudresourcemanager.googleapis.com/v3/FOLDER_ID:setIamPolicy

מחליפים את FOLDER_ID בשם התיקייה שמגדירים לה את מדיניות ה-IAM, לדוגמה folders/123.

כל Folder Admin יכול להקצות למשתמשים מהדומיין המשויך את התפקיד Project Creator.

דוגמה

התרשים הבא ממחיש ארגון עם דומיין ראשי שמופרד מדומיין משני שנרכש. לכל אחד משני הדומיינים יש חשבון Google Workspace משלו, ו-hypothetical.com הוא משאב הארגון הראשי.

דיאגרמה של ההיררכיה