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

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

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

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

איך זה עובד

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

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

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

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

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

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

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

הפעלת ממשקי ה-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

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

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