‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

הכללת משאבים בדומיינים של נתונים

במאמר הזה מוסבר איך לכלול משאבים בדומיינים של נתונים כדי לארגן את הנתונים.

אפשר לכלול משאב בדומיין אחד בכל פעם. אי אפשר להוסיף משאב יחיד לכמה דומיינים. * אפשר לכלול עד 500 משאבים ישירים בדומיין נתונים יחיד.

איך זה עובד

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

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

מידע על הרשאה של דומיין נתונים

הרשאת דומיין יוצרת אמון בין המשאב לבין הדומיין. בעלי המשאב מעניקים הרשאות IAM לחשבון המשתמש של IAM בדומיין הנתונים במשאב או בפרויקט היעד. הפעולה הזו מאפשרת ל-Knowledge Catalog לאשר וליצור את הקישור שמקשר את המשאב לדומיין.

אימות ההרשאה של הדומיין מתבצע רק כשנוצרת כריכה. כלומר, אם מבטלים את תפקיד ה-IAM של חשבון המשתמש בדומיין במשאב, המשאב לא מבוטל אוטומטית או מוסר מהדומיין. משתמשים בדומיין עם התפקיד roles/dataplex.dataDomainEntryReader יכולים להמשיך לגלות את המשאב ולראות את המטא-נתונים שלו עד שמחיקת הקישור בין המשאב לדומיין מתבצעת באופן מפורש.

הרשאה לדומיין והרשאות משתמשים בדומיין

כשעובדים עם דומיינים של נתונים, חשוב להבחין בין הרשאה של דומיין נתונים לבין מתן הרשאות דומיין נתונים למשתמש:

הרשאה לדומיין נתונים: הכוונה היא להרשאה לדומיין הנתונים במשאב יעד. אתם מעניקים להרשאות העיקריות של IAM בדומיין הנתונים הרשאות במשאב בסיסי, כמו פרויקט או מערך נתונים ב-BigQuery, כדי ליצור את הקישור בין המשאב לבין הדומיין.
הענקת הרשאות למשתמש בדומיין נתונים: הכוונה היא להענקת הרשאות למשתמש או לחשבון שירות כדי לבצע פעולות בדומיין הנתונים עצמו. אתם נותנים תפקידי IAM למשתמשים ישירות בדומיין הנתונים, כדי שהם יוכלו לצפות בדומיין, לערוך אותו או לנהל אותו ב-Knowledge Catalog. מידע נוסף זמין במאמר תפקידים והרשאות בדומיין נתונים.

סוגי התפקידים

כשמאשרים תחום נתונים במשאב יעד, אפשר לבחור תפקיד IAM שמשתייך לאחד מסוגי התפקידים הבאים: Reader,‏ Writer או Admin.

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

סוגי התפקידים 'כותב' מאפשרים לדומיין לנהל את הרשאות העריכה של המטא-נתונים במשאב.
סוגי תפקידי אדמין מאפשרים לדומיין לנהל את כל ההרשאות במשאב.

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

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

תפקידים מומלצים להרשאת דומיין

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

בוחרים את סוג המשאב שרוצים לראות את התפקידים שלו מהרשימה.

סוג המשאב	סוג התפקיד	תפקידים מומלצים	תיאור	ההרשאות הנדרשות
פרויקט	משתמש בעל הרשאת קריאה	`roles/browser`	מעניקה לדומיין הרשאות לקבל מידע על פרויקט.	`resourcemanager.projects.get`
	משתמש בעל הרשאת כתיבה	`roles/editor`	מעניק לדומיין הרשאות לקבל מידע על פרויקט ולנהל את המטא-נתונים שלו.	`resourcemanager.projects.get` `resourcemanager.projects.update`
	אדמין	`roles/owner`	ההרשאה הזו מאפשרת לאדמינים בדומיין לנהל פרויקט, כולל גילוי, ניהול מטא-נתונים וניהול מדיניות גישה.	`resourcemanager.projects.get` `resourcemanager.projects.update` `resourcemanager.projects.setIamPolicy`
מערך נתונים ב-BigQuery	משתמש בעל הרשאת קריאה	`roles/bigquery.metadataViewer`	נותן לדומיין הרשאות לקבל מידע על מערך נתונים ב-BigQuery.	`bigquery.datasets.get`
	משתמש בעל הרשאת כתיבה	`roles/bigquery.dataEditor`	נותן לדומיין הרשאות לקבל מידע על מערך נתונים ב-BigQuery ולנהל את המטא-נתונים שלו.	`bigquery.datasets.get` `bigquery.datasets.updateTag`
	אדמין	`roles/bigquery.dataOwner`	נותן לאדמין בדומיין ניהול אדמיניסטרטיבי של קבוצת נתונים ב-BigQuery, כולל גילוי, ניהול מטא-נתונים וניהול מדיניות גישה.	`bigquery.datasets.get` `bigquery.datasets.updateTag` `bigquery.datasets.setIamPolicy`
טבלה ב-BigQuery	משתמש בעל הרשאת קריאה	`roles/bigquery.metadataViewer`	ההרשאה מאפשרת לדומיין לקבל מידע על טבלה ב-BigQuery.	`bigquery.tables.get`
	משתמש בעל הרשאת כתיבה	`roles/bigquery.dataEditor`	נותן לדומיין הרשאות לקבל מידע על טבלה ב-BigQuery ולנהל את המטא-נתונים שלה.	`bigquery.tables.get` `bigquery.tables.update`
	אדמין	`roles/bigquery.dataOwner`	ההרשאה מאפשרת לאדמין בדומיין לנהל טבלה ב-BigQuery, כולל גילוי, ניהול מטא-נתונים וניהול מדיניות הגישה.	`bigquery.tables.get` `bigquery.tables.update` `bigquery.tables.setIamPolicy`
מוצר נתונים	משתמש בעל הרשאת קריאה	`roles/dataplex.dataProductsViewer`	ההרשאה מאפשרת לדומיין לקבל מידע על מוצר נתונים.	`dataplex.dataProducts.get`
	משתמש בעל הרשאת כתיבה	`roles/dataplex.dataProductsEditor`	ההרשאה הזו מאפשרת לדומיין לקבל מידע על מוצר נתונים ולנהל את המטא-נתונים שלו.	`dataplex.dataProducts.get` `dataplex.dataProducts.update`
	אדמין	`roles/dataplex.dataProductsAdmin`	ההרשאה הזו מאפשרת ניהול אדמיניסטרטיבי של מוצר נתונים בדומיין, כולל גילוי מוצר נתונים, ניהול מטא-נתונים וניהול מדיניות הגישה.	`dataplex.dataProducts.get` `dataplex.dataProducts.update` `dataplex.dataProducts.setIamPolicy`
מאגר Dataform	משתמש בעל הרשאת קריאה	`roles/dataform.codeViewer`	מעניק לדומיין הרשאת קריאה בלבד למשאבי קוד של Dataform.	`dataform.repositories.get`
	משתמש בעל הרשאת כתיבה	`roles/dataform.codeOwner`	נותן לדומיין גישה מלאה למאגר Dataform ולמשאבי הקוד.	`dataform.repositories.get dataform.repositories.update`
	אדמין	`roles/dataform.codeOwner`	מעניק לדומיין גישה מלאה למאגר Dataform ולמשאבי קוד.	`dataform.repositories.get dataform.repositories.setIamPolicy`
מסד נתונים של Dataproc Metastore	משתמש בעל הרשאת קריאה	`roles/metastore.metadataUser`	מעניק לדומיין הרשאות לקבל את רשימת מסדי הנתונים של Dataproc Metastore.	`metastore.databases.get`
	משתמש בעל הרשאת כתיבה	`roles/metastore.metadataEditor`	ההרשאה הזו מאפשרת לדומיין לקרוא ולשנות את המטא-נתונים של מסדי נתונים וטבלאות ב-Dataproc Metastore במסגרת אותם מסדי נתונים.	`metastore.databases.get metastore.databases.update`
	אדמין	`roles/metastore.metadataOwner`	מעניק לדומיין גישה מלאה למטא-נתונים של מסדי נתונים וטבלאות ב-Dataproc Metastore במסגרת מסדי הנתונים האלה.	`metastore.databases.get metastore.databases.setIamPolicy`
טבלה של Dataproc Metastore	משתמש בעל הרשאת קריאה	`roles/metastore.metadataViewer`	מעניק לדומיין גישה לקריאת המטא-נתונים של מסדי נתונים וטבלאות ב-Dataproc Metastore במסגרת אותם מסדי נתונים.	`metastore.tables.get`
	משתמש בעל הרשאת כתיבה	`roles/metastore.metadataEditor`	ההרשאה הזו מאפשרת לדומיין לקרוא ולשנות את המטא-נתונים של מסדי נתונים וטבלאות ב-Dataproc Metastore במסגרת אותם מסדי נתונים.	`metastore.tables.get`
	אדמין	`roles/metastore.metadataOwner`	מעניק לדומיין גישה מלאה למטא-נתונים של מסדי נתונים וטבלאות ב-Dataproc Metastore במסגרת מסדי הנתונים האלה.	`metastore.tables.get metastore.tables.setIamPolicy`
מסד נתונים של Cloud Spanner	משתמש בעל הרשאת קריאה	`roles/spanner.databaseReader`	ההרשאה הזו מאפשרת לדומיין לקרוא ממסד הנתונים של Spanner, להריץ שאילתות SQL ולצפות בסכימה של מסד הנתונים.	`spanner.databases.get`
	משתמש בעל הרשאת כתיבה	`roles/spanner.editor`	נותן לדומיין הרשאות ניהול ותפעול במשאבי Spanner, כולל ניהול מופעים וניהול מסדי נתונים, ביצוע שאילתות, ניהול גיבוי ושחזור וניהול משאבים.	`spanner.databases.get spanner.databases.update`
	אדמין	`roles/spanner.databaseAdmin`	התפקיד הזה נותן לדומיין גישה מלאה לניהול מופעי Spanner בפרויקט ומסדי נתונים במופעים האלה.	`spanner.databases.get spanner.databases.setIamPolicy`
טבלת BigLake	משתמש בעל הרשאת קריאה	`roles/biglake.metadataViewer`	ההרשאה מאפשרת לדומיין גישה לקריאה בלבד של מטא-נתונים לכל משאבי BigLake.	`biglake.tables.get`
	משתמש בעל הרשאת כתיבה	`roles/biglake.editor`	מעניקה לדומיין הרשאת קריאה וכתיבה לכל משאבי BigLake.	`biglake.tables.get biglake.tables.update`
	אדמין	`roles/biglake.admin`	מעניקה לדומיין גישה מלאה לכל המשאבים של BigLake.	`biglake.tables.get biglake.tables.setIamPolicy`
מכונת AlloyDB ל-PostgreSQL	משתמש בעל הרשאת קריאה	`roles/alloydb.viewer`	מעניק לדומיין הרשאת קריאה בלבד למשאבי AlloyDB ל-PostgreSQL.	`alloydb.instances.get`
מכונת AlloyDB ל-PostgreSQL	משתמש בעל הרשאת כתיבה	`roles/alloydb.editor`	מעניק לדומיין גישת קריאה וכתיבה למשאבי AlloyDB ל-PostgreSQL.	`alloydb.instances.get alloydb.instances.update`
מערך הנתונים של Gemini Enterprise Agent Platform	משתמש בעל הרשאת קריאה	`roles/aiplatform.viewer`	נותן לדומיין הרשאות לצפייה בכל המשאבים ב-Gemini Enterprise Agent Platform.	`aiplatform.datasets.get`
מערך הנתונים של Gemini Enterprise Agent Platform	משתמש בעל הרשאת כתיבה	`roles/aiplatform.user`	ההרשאה הזו מאפשרת לדומיין להשתמש בכל המשאבים ב-Gemini Enterprise Agent Platform.	`aiplatform.datasets.get aiplatform.datasets.update`

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

לפני שכוללים משאבים בדומיין נתונים, צריך לוודא שיש לכם את התפקידים הנדרשים ושהפעלתם את ממשקי ה-API.

הפעלת ממשקי ה-API

מפעילים את Dataplex API.

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

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

להפעלת ה-API

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

כדי לקבל את ההרשאות שדרושות לקישור משאבים לדומיינים של נתונים, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט:

ניהול דומיינים וקישורי משאבים: עריכת דומיין נתונים ב-Dataplex (roles/dataplex.dataDomainEditor)

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

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

קבלת נציג ה-IAM של הדומיין

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

המסוף

נכנסים לדף Data domains במסוף Google Cloud .

מעבר אל "דומיינים של נתונים"
לוחצים על שם הדומיין כדי לעבור לדף פרטי הדומיין.
בכרטיסייה סקירה כללית, עוברים אל מידע ואז אל מזהים.
מעתיקים את הערך של IAM principal. הפורמט דומה לזה:

principal://dataplex.googleapis.com/projects/DOMAIN_PROJECT_NUMBER/name/locations/LOCATION_ID/dataDomains/DOMAIN_ID

REST

כדי לקבל את נציג הדומיין באמצעות ה-API בארכיטקטורת REST, משתמשים ב-method ‏projects.locations.dataDomains.get כדי לקבל את נתוני הדומיין. התשובה כוללת את השדה policyMember שמכיל את הגורם הראשי ב-IAM (iamPolicyNamePrincipal או iamPolicyUidPrincipal) של הדומיין:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫LOCATION_ID: האזור שבו קיים דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: המזהה הייחודי של דומיין הנתונים או של תת-הדומיין.

ה-method של ה-HTTP וכתובת ה-URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID

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

curl

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID"

PowerShell

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

איך מאשרים את הדומיין במשאב

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

המסוף

במסוף Google Cloud , עוברים למשאב היעד ופותחים את חלונית ההרשאות של המשאב:
- בפרויקטים, במערכי נתונים של פלטפורמת הסוכנים של Gemini Enterprise, בטבלאות ובמסדי נתונים של Dataproc Metastore, במאגרי Dataform, במכונות של AlloyDB ל-PostgreSQL ובטבלאות BigLake, עוברים לדף IAM ולוחצים על Grant access (הענקת גישה).
- לגבי מוצרי נתונים, עוברים לדף מוצרי נתונים, בוחרים את מוצר הנתונים ולוחצים על שיתוף > הגדרת הרשאות.
- כדי לשתף מערכי נתונים וטבלאות ב-BigQuery, עוברים לדף BigQuery, בוחרים מערך נתונים או טבלה ולוחצים על שיתוף > ניהול הרשאות.
- למסדי נתונים של Spanner, עוברים לדף Spanner, בוחרים את מסד הנתונים ולוחצים על הכרטיסייה הרשאות.
לוחצים על Add Principal או על לחצן מקביל.
בשדה New principals, מדביקים את חשבון המשתמש ב-IAM של הדומיין. הוראות לקבלת חשבון המשתמש של הדומיין מופיעות בקטע קבלת חשבון המשתמש של הדומיין ב-IAM.
בתפריט Select a role, בוחרים את התפקיד שמתאים למטרה שלכם. רשימת התפקידים המלאה מופיעה בקטע תפקידים מומלצים להרשאת דומיין. ממתינים שתיים עד שלוש דקות עד שהשינויים יופצו.
לוחצים על Save.

gcloud

משתמשים בפקודה של Google Cloud CLI עבור המוצר כדי להעניק את התפקיד הנדרש לישות הראשית של הדומיין:

principal://dataplex.googleapis.com/projects/DOMAIN_PROJECT_NUMBER/name/locations/LOCATION_ID/dataDomains/DOMAIN_ID

לדוגמה, שימוש ב-gcloud כדי לקשר פרויקט:

gcloud projects add-iam-policy-binding RESOURCE_PROJECT_ID \
--member "principal://dataplex.googleapis.com/projects/DOMAIN_PROJECT_NUMBER/name/locations/LOCATION_ID/dataDomains/DOMAIN_ID" \
--role ROLE

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

‫RESOURCE_PROJECT_ID: המזהה של פרויקט היעד שרוצים לתת לו הרשאה.
‫DOMAIN_PROJECT_NUMBER: מספר הפרויקט שמארח את דומיין הנתונים.
‫LOCATION_ID: האזור שבו קיים דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: מזהה תחום הנתונים.
‫ROLE: תפקיד ה-IAM שמתאים למטרת הקישור הנדרשת.

לפני שמשתמשים בפקודות מוצר ספציפיות, כמו bq add-iam-policy-binding ל-BigQuery, כדאי לעיין במסמכי ה-API של המוצר.

REST

כדי להעניק להרשאה העיקרית של הדומיין הרשאות למשאב, בדרך כלל מקבלים את מדיניות ה-IAM הקיימת באמצעות getIamPolicy, מוסיפים את הקישור של ההרשאה העיקרית של הדומיין עם התפקיד שבחרתם ומגדירים את המדיניות המעודכנת באמצעות setIamPolicy.

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

טעינת מדיניות ה-IAM הנוכחית

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫RESOURCE_PROJECT_ID: המזהה של פרויקט היעד שרוצים לתת לו הרשאה.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://cloudresourcemanager.googleapis.com/v1/projects/RESOURCE_PROJECT_ID:getIamPolicy

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

curl

מריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://cloudresourcemanager.googleapis.com/v1/projects/RESOURCE_PROJECT_ID:getIamPolicy"

PowerShell

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://cloudresourcemanager.googleapis.com/v1/projects/RESOURCE_PROJECT_ID:getIamPolicy" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

הגדרת המדיניות המעודכנת, כולל חשבון המשתמש בדומיין

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫RESOURCE_PROJECT_ID: המזהה של פרויקט היעד שרוצים לתת לו הרשאה.
‫DOMAIN_PROJECT_NUMBER: מספר הפרויקט שמארח את דומיין הנתונים.
‫LOCATION_ID: האזור שבו קיים דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: מזהה תחום הנתונים.
‫ROLE: תפקיד ה-IAM שמתאים למטרת הקישור הנדרשת.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://cloudresourcemanager.googleapis.com/v1/projects/RESOURCE_PROJECT_ID:setIamPolicy

גוף בקשת JSON:

{
  "policy": {
    "bindings": [
      {
        "role": "ROLE",
        "members": [
          "principal://dataplex.googleapis.com/projects/DOMAIN_PROJECT_NUMBER/name/locations/LOCATION_ID/dataDomains/DOMAIN_ID"
        ]
      }
    ]
  }
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v1/projects/RESOURCE_PROJECT_ID:setIamPolicy"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v1/projects/RESOURCE_PROJECT_ID:setIamPolicy" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

הוראות להגדרת מדיניות למשאבים אחרים מופיעות במאמרי העזרה הבאים של ה-API:

קישור משאבים לדומיין

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

המסוף

נכנסים לדף Data domains במסוף Google Cloud .

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

REST

כדי לכלול משאב בדומיין, משתמשים ב-method ‏projects.locations.dataDomains.bindings.create.

כדי לראות את מטען הייעודי (payload) של המשאב שרוצים לכלול בדומיין, מרחיבים את אחד מהקטעים הבאים:

פרויקט

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud שמארח את דומיין הנתונים.
‫LOCATION_ID: האזור שבו קיים דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: המזהה הייחודי של תחום הנתונים.
‫RESOURCE_PROJECT_ID: מזהה פרויקט היעד שרוצים לכלול בדומיין.
‫BINDING_ID: מזהה ייחודי אופציונלי של הקישור הזה של המשאב.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

גוף בקשת JSON:

{
  "resource": "//cloudresourcemanager.googleapis.com/projects/RESOURCE_PROJECT_ID"
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

מערך נתונים וטבלה ב-BigQuery

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud שמארח את דומיין הנתונים.
‫LOCATION_ID: האזור שבו קיים דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: המזהה הייחודי של תחום הנתונים.
‫RESOURCE_PROJECT_ID: המזהה של Google Cloud הפרויקט שמארח את המשאב.
‫DATASET_ID: המזהה של משאב היעד (למשל מערך נתונים ב-BigQuery).
‫BINDING_ID: מזהה ייחודי אופציונלי של הקישור הזה של המשאב.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

גוף בקשת JSON:

{
  "resource": "//bigquery.googleapis.com/projects/RESOURCE_PROJECT_ID/datasets/DATASET_ID"
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

מוצר נתונים

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud שמארח את דומיין הנתונים.
‫LOCATION_ID: האזור שבו נמצאים דומיין הנתונים והמשאב. לדוגמה, us-central1.
‫DOMAIN_ID: המזהה הייחודי של תחום הנתונים.
‫RESOURCE_PROJECT_ID: מזהה ה Google Cloud פרויקט שמארח את מוצר הנתונים.
‫DATA_PRODUCT_ID: המזהה הייחודי של מוצר הנתונים של היעד.
‫BINDING_ID: מזהה ייחודי אופציונלי של הקישור הזה של המשאב.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

גוף בקשת JSON:

{
  "resource": "//dataplex.googleapis.com/projects/RESOURCE_PROJECT_ID/locations/LOCATION_ID/dataProducts/DATA_PRODUCT_ID"
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

מאגר Dataform

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫DOMAIN_PROJECT_ID: מזהה הפרויקט שמארח את דומיין הנתונים.
‫DOMAIN_LOCATION_ID: האזור שבו מתארח דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: מזהה תחום הנתונים.
‫BINDING_ID: המזהה להקצאה לקישור החדש של תחום הנתונים.
‫PROJECT_ID: מזהה הפרויקט שמארח את המאגר.
‫LOCATION_ID: האזור שבו מתארח המאגר.
‫REPOSITORY_ID: המזהה של מאגר Dataform.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

גוף בקשת JSON:

{
  "resource": "//dataform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID"
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

מסד נתונים של Dataproc Metastore

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫DOMAIN_PROJECT_ID: מזהה הפרויקט שמארח את דומיין הנתונים.
‫DOMAIN_LOCATION_ID: האזור שבו מתארח דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: מזהה תחום הנתונים.
‫BINDING_ID: המזהה להקצאה לקישור החדש של תחום הנתונים.
‫PROJECT_ID: המזהה של הפרויקט שמארח את מסד הנתונים.
‫LOCATION_ID: האזור שבו מתארח השירות.
‫SERVICE_ID: המזהה של שירות Dataproc Metastore.
‫DATABASE_ID: מזהה מסד הנתונים.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

גוף בקשת JSON:

{
  "resource": "//metastore.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID/databases/DATABASE_ID"
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

טבלה של Dataproc Metastore

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫DOMAIN_PROJECT_ID: מזהה הפרויקט שמארח את דומיין הנתונים.
‫DOMAIN_LOCATION_ID: האזור שבו מתארח דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: מזהה תחום הנתונים.
‫BINDING_ID: המזהה להקצאה לקישור החדש של תחום הנתונים.
‫PROJECT_ID: מזהה הפרויקט שמארח את הטבלה.
‫LOCATION_ID: האזור שבו מתארח השירות.
‫SERVICE_ID: המזהה של שירות Dataproc Metastore.
‫DATABASE_ID: מזהה מסד הנתונים.
‫TABLE_ID: מזהה הטבלה.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

גוף בקשת JSON:

{
  "resource": "//metastore.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID/databases/DATABASE_ID/tables/TABLE_ID"
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

מסד נתונים של Spanner

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫DOMAIN_PROJECT_ID: מזהה הפרויקט שמארח את דומיין הנתונים.
‫DOMAIN_LOCATION_ID: האזור שבו מתארח דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: מזהה תחום הנתונים.
‫BINDING_ID: המזהה להקצאה לקישור החדש של תחום הנתונים.
‫PROJECT_ID: המזהה של הפרויקט שמארח את מסד הנתונים.
‫INSTANCE_ID: המזהה של מכונת Spanner.
‫DATABASE_ID: מזהה מסד הנתונים.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

גוף בקשת JSON:

{
  "resource": "//spanner.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID"
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

BigLake

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫DOMAIN_PROJECT_ID: מזהה הפרויקט שמארח את דומיין הנתונים.
‫DOMAIN_LOCATION_ID: האזור שבו מתארח דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: מזהה תחום הנתונים.
‫BINDING_ID: המזהה להקצאה לקישור החדש של תחום הנתונים.
‫PROJECT_ID: מזהה הפרויקט שמארח את הקטלוג.
‫LOCATION_ID: האזור שבו מתארח הקטלוג.
‫CATALOG_ID: מזהה הקטלוג.
‫DATABASE_ID: מזהה מסד הנתונים.
‫TABLE_ID: מזהה הטבלה.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

גוף בקשת JSON:

{
  "resource": "//biglake.googleapis.com/projects/PROJECT_ID/catalogs/CATALOG_ID/databases/DATABASE_ID/tables/TABLE_ID"
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

‫AlloyDB ל-PostgreSQL

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫DOMAIN_PROJECT_ID: מזהה הפרויקט שמארח את דומיין הנתונים.
‫DOMAIN_LOCATION_ID: האזור שבו מתארח דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: מזהה תחום הנתונים.
‫BINDING_ID: המזהה להקצאה לקישור החדש של תחום הנתונים.
‫PROJECT_ID: מזהה הפרויקט שמארח את האשכול.
‫LOCATION_ID: האזור שבו מתארח האשכול.
‫CLUSTER_ID: מזהה האשכול.
‫INSTANCE_ID: מזהה המכונה.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

גוף בקשת JSON:

{
  "resource": "//alloydb.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID"
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

פלטפורמת הסוכנים של Gemini Enterprise

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫DOMAIN_PROJECT_ID: מזהה הפרויקט שמארח את דומיין הנתונים.
‫DOMAIN_LOCATION_ID: האזור שבו מתארח דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: מזהה תחום הנתונים.
‫BINDING_ID: המזהה להקצאה לקישור החדש של תחום הנתונים.
‫PROJECT_ID: מזהה הפרויקט שמארח את מערך הנתונים.
‫LOCATION_ID: האזור שבו מתארח מערך הנתונים.
‫DATASET_ID: מזהה קבוצת הנתונים.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

גוף בקשת JSON:

{
  "resource": "//aiplatform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/datasets/DATASET_ID"
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

צפייה במשאבים הכלולים

אפשר לראות את התיקיות, הפרויקטים והמשאבים שקשורים ישירות לדומיין נתונים.

המסוף

נכנסים לדף Data domains במסוף Google Cloud .

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

REST

כדי להציג רשימה של קשרי משאבים שכלולים, משתמשים בשיטה projects.locations.dataDomains.bindings.list:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫LOCATION_ID: האזור שבו קיים דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: המזהה הייחודי של תחום הנתונים.

ה-method של ה-HTTP וכתובת ה-URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings

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

curl

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings"

PowerShell

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

הסרת משאב מהדומיין

הסרת משאב מבטלת את הקישור שלו להיררכיית דומיין הנתונים.

המסוף

נכנסים לדף Data domains במסוף Google Cloud .

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

REST

כדי למחוק קישור משאב, משתמשים בשיטה projects.locations.dataDomains.bindings.delete.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫LOCATION_ID: האזור שבו קיים דומיין הנתונים. לדוגמה, us-central1.
‫DOMAIN_ID: המזהה הייחודי של תחום הנתונים.
‫BINDING_ID: המזהה הייחודי של שיוך המשאב.

ה-method של ה-HTTP וכתובת ה-URL:

DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings/BINDING_ID

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

curl

מריצים את הפקודה הבאה:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings/BINDING_ID"

PowerShell

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings/BINDING_ID" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

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

איך זה עובד

מידע על הרשאה של דומיין נתונים

הרשאה לדומיין והרשאות משתמשים בדומיין

סוגי התפקידים

תפקידים מומלצים להרשאת דומיין

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

הפעלת ממשקי ה-API

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

קבלת נציג ה-IAM של הדומיין

המסוף

REST

curl

PowerShell

איך מאשרים את הדומיין במשאב

המסוף

gcloud

REST

טעינת מדיניות ה-IAM הנוכחית

curl

PowerShell

הגדרת המדיניות המעודכנת, כולל חשבון המשתמש בדומיין

curl

PowerShell

קישור משאבים לדומיין

המסוף

REST

פרויקט

curl

PowerShell

מערך נתונים וטבלה ב-BigQuery

curl

PowerShell

מוצר נתונים

curl

PowerShell

מאגר Dataform

curl

PowerShell

מסד נתונים של Dataproc Metastore

curl

PowerShell

טבלה של Dataproc Metastore

curl

PowerShell

מסד נתונים של Spanner

curl

PowerShell

BigLake

curl

PowerShell

‫AlloyDB ל-PostgreSQL

curl

PowerShell

פלטפורמת הסוכנים של Gemini Enterprise

curl

PowerShell

צפייה במשאבים הכלולים

המסוף

REST

curl

PowerShell

הסרת משאב מהדומיין

המסוף

REST

curl

PowerShell

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

הכללת משאבים בדומיינים של נתונים