במאמר זה נסביר איך ליצור, להסיר ולמחוק פרויקטים של דיירים.
ממשק ה-Service Consumer Management API משמש ליצירה ולהגדרה של פרויקטים של דיירים (tenant projects) –Google Cloud פרויקטים שמשמשים לאירוח משאבי השירות המנוהל שלכם, שמיועדים לצרכן שירות יחיד. כל פרויקט דייר (tenant) משויך ליחידה ייעודית לדייר בענן.
יחידה ייעודית לדייר בענן יכולה לכלול מספר פרויקטים של דיירים, שלכל אחד מהם מוקצה מזהה tag: string שמשמש לציון מטרת הפרויקט ולביטול של ניהול הקצאות.
לאחר יצירתו, פרויקט דייר (tenant) הוא למעשה פרויקט ב- Google Cloud בארגון שלכם. בפרויקט של דייר אפשר להשתמש בכל אחד מכלי הניהול, בדומה לשימוש בהם בפרויקט Google Cloud .
יצירת פרויקט של דייר (tenant)
כדי ליצור פרויקט דייר (tenant) ולהוסיף אותו ליחידה ייעודית לדייר בענן, צריך לבצע קריאה ל-method services.tenancyUnits.addProject.
בדוגמה הבאה מוסיפים ליחידה ייעודית לדייר בענן פרויקט דייר (tenant) חדש עם התג tag1, באמצעות ה-API בארכיטקטורת REST:
POST https://serviceconsumermanagement.googleapis.com/v1/services/your-service.example.com/projects/12345678901/tenancyUnits/absdef:addProject
הקריאה כוללת את הנתונים הבאים:
{"tag":"tag1", "project_config":{"folder":"folders/9876543210", "tenant_project_policy":{"policy_bindings":{"role":"roles/owner", "members":"user:bob@example.com"}}, "billing_config":{"billing_account":"billingAccounts/123456-472F22-28F9AA"}}}
הקריאה מחזירה פעולה ממושכת, שאפשר לבצע שאילתה לגביה כדי לאשר שהפרויקט נוצר ללא בעיות.
הפרויקט החדש של הדייר מוגדר באמצעות מנעול למניעת מחיקה של פרויקט – הגדרת מאפיין בפרויקט של דייר שמונעת מחיקה שלו בטעות. כדי לשחרר את המנעול למניעת מחיקה ולמחוק את הפרויקט, צריך לבצע קריאה ל-method services.tenancyUnits.removeProject. לא מומלץ לעקוף את אמצעי ההגנה הזה.
פרויקט הדייר נוצר בתיקייה שציינתם בשלב ההגדרה והתצורה. אחרי שיוצרים פרויקט, לא מומלץ להעביר אותו לתיקייה אחרת.
חשבון השירות של ממשק ה-API לניהול של צרכני השירות הוא היוצר והבעלים של פרויקטים של דיירים, בנוסף לבעלים אחרים שמצוינים בהגדרות הפרויקטים האלה. לא מומלץ להסיר את החשבון הזה כבעלים.
במקרים מסוימים, כדאי להפוך פרויקט קיים Google Cloud לפרויקט של דייר במקום ליצור פרויקט חדש של דייר. כדי להוסיף פרויקט קיים שלGoogle Cloud ליחידה ייעודית לדייר בענן, צריך לבצע קריאה ל-method services.tenancyUnits.attachProject.
הסרת פרויקט של דייר (tenant)
כדי להסיר פרויקט של דייר עם התג abc, צריך לבצע קריאה ל-method services.tenancyUnits.removeProject בהתאם לדוגמה הבאה:
POST https://serviceconsumermanagement.googleapis.com/v1/services/your-service.example.com/projects/12345678901/tenancyUnits/absdef:removeProject
הקריאה כוללת את הנתונים הבאים:
{"tag":"abc"}
הפעולה הזו מסירה את המנעול למניעת מחיקה של הפרויקט, מוחקת את הפרויקט ואת כל המשאבים שכלולים בו ומוחקת את כל המטא-נתונים המשויכים אליו מהיחידה הייעודית לדייר בענן.
באופן כזה, מוחקים את הפרויקט ומסירים את כל המטא-נתונים שלו מהיחידה הייעודית לדייר בענן. אם רוצים למחוק את הפרויקט אבל לשמור תיעוד שלו, צריך לבצע במקום זאת קריאה ל-method services.tenancyUnits.deleteProject. כך אפשר למחוק את הפרויקט ולשמור את המטא-נתונים עם אנוטציה של מצב DELETED. כדי לבטל מחיקה של פרויקט שנמחק, צריך לבצע קריאה ל-method services.tenancyUnits.undeleteProject.