החל מ-10 באפריל 2026, Dataplex Universal Catalog נקרא עכשיו Knowledge Catalog. השמות של ה-API, ספריית הלקוח, ה-CLI ו-IAM לא משתנים. מידע נוסף זמין במאמר הכרות עם קטלוג הידע של Google Cloud.

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

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

דומיינים של נתונים ב-Knowledge Catalog (לשעבר Dataplex Universal Catalog) מאפשרים לארגן פרויקטים, מוצרי נתונים ונכסים ספציפיים, כמו מערכי נתונים וטבלאות ב-BigQuery, בהיררכיה לוגית. אחרי שמאשרים דומיין ויוצרים קישורי משאבים, המשתמשים יכולים לחפש בהקשר העסקי הזה כדי לגלות את המשאבים הכלולים ולראות את המטא-נתונים שלהם.

איך זה עובד

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

סוג המשאב	סוג התפקיד	תפקידים מומלצים	תיאור	ההרשאות הנדרשות
פרויקט	הרשאת קריאה	`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.	`aiplatform.datasets.get aiplatform.datasets.update`

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

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

משאב יכול להשתייך רק לדומיין אחד.
דומיין יכול להכיל עד 500 משאבים.

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

מפעילים את Dataplex API, אם הוא עדיין לא מופעל.

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

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

להפעלת ה-API

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

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

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

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

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

קבלת חשבון המשתמש של הדומיין ב-IAM

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

המסוף

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

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

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 Agent Platform, במסדי נתונים ובטבלאות של Dataproc Metastore, במאגרים של Dataform, במכונות של AlloyDB ל-PostgreSQL ובטבלאות של BigLake, נכנסים לדף IAM ולוחצים על Grant access.
- במוצרי נתונים, נכנסים לדף Data Products, בוחרים את מוצר הנתונים ולוחצים על Share > Set permissions.
- למערכי נתונים וטבלאות ב-BigQuery, נכנסים לדף BigQuery, בוחרים מערך נתונים או טבלה ולוחצים על שיתוף > ניהול הרשאות.
- במסדי נתונים של Spanner, נכנסים לדף Spanner, בוחרים את מסד הנתונים ולוחצים על הכרטיסייה Permissions.
לוחצים על 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 .

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

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

כדי להציג את רשימת הקישורים של המשאבים הכלולים, משתמשים ב-method‏ 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

כדי למחוק קישור של משאב, משתמשים ב-method ‏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

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

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