יצירת דומיינים של נתונים

המסוף

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

   אל "דומיינים של נתונים"

2. לוחצים על יצירת דומיין נתונים ומזינים את הפרטים הבאים:

   • בשדה שם לתצוגה, מציינים שם ידידותי למשתמש לדומיין. לדוגמה, Finance.
   • בשדה Data Domain ID (מזהה דומיין נתונים), מציינים מזהה ייחודי לדומיין. אי אפשר לשנות את הערך הזה אחרי שהמערכת יוצרת את הדומיין.
   • בשדה מיקום, בוחרים את האזור שבו רוצים ליצור את דומיין הנתונים.
   • בשדה מזהה פרויקט, בוחרים את הפרויקט שבו רוצים ליצור את תחום הנתונים.
   • אופציונלי: בשדה תיאור, מזינים תיאור קצר של הדומיין.
   • בשדה בעלים, מוסיפים בעלים אחד או יותר של הדומיין. אפשר להזין כמה כתובות אימייל בו-זמנית.

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

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

REST

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

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

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

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

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?data_domain_id=DATA_DOMAIN_ID

תוכן בקשת JSON:

{
  "display_name": "Finance Domain",
  "description": "Domain for finance datasets and reports.",
  "contacts": {
    "identities": [
      {
        "contact_name": "Alice Wonderland",
        "contact_role": "owner",
        "contact_id": "alice@example.com"
      }
    ]
  }
}

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

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?data_domain_id=DATA_DOMAIN_ID"

$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?data_domain_id=DATA_DOMAIN_ID" | Select-Object -Expand Content

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

המסוף

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

   אל "דומיינים של נתונים"

2. בוחרים את הדומיין שרוצים ליצור לו תת-דומיין.

3. לוחצים על יצירת תת-דומיין לנתונים ומזינים את הפרטים הבאים:

   • בשדה שם לתצוגה, מציינים שם ידידותי למשתמש לדומיין. לדוגמה, Finance.
   • בשדה Data Domain ID (מזהה דומיין נתונים), מציינים מזהה ייחודי לדומיין. אי אפשר לשנות את הערך הזה אחרי שהמערכת יוצרת את הדומיין.
   • אופציונלי: בשדה תיאור, מזינים תיאור קצר של הדומיין.
   • בשדה בעלים, מוסיפים את כתובת האימייל של בעל הדומיין. אפשר להזין כמה כתובות אימייל בו-זמנית.

4. אופציונלי: בשדה תוויות, מזינים תוויות כדי לקבץ אובייקטים קשורים או משאבים אחרים של Google Cloud .

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

REST

כדי ליצור תת-דומיין של נתונים, משתמשים בשיטה projects.locations.dataDomains.create ומציינים את parent_data_domain בגוף הבקשה.

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

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

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

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?data_domain_id=SUBDOMAIN_ID

תוכן בקשת JSON:

{
  "display_name": "Finance Subdomain",
  "description": "A subdomain within the Finance domain.",
  "contacts": {
    "identities": [
      {
        "contact_name": "Alice Wonderland",
        "contact_role": "owner",
        "contact_id": "alice@example.com"
      }
    ]
  },
  "parent_data_domain": "projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/PARENT_DATA_DOMAIN_ID"
}

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

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?data_domain_id=SUBDOMAIN_ID"

$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?data_domain_id=SUBDOMAIN_ID" | Select-Object -Expand Content

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

המסוף

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

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

   אל "דומיינים של נתונים"

2. לוחצים על שם הדומיין כדי לעבור לדף פרטי הדומיין.

3. בסרגל העליון, לוחצים על הרשאות.

4. לוחצים על Add principal.

5. בשדה New principals, מזינים את כתובת האימייל של חשבון המשתמש.

6. בשדה Select a role (בחירת תפקיד), בוחרים את התפקיד של תחום הנתונים. לדוגמה, משתמשים ב-Dataplex Data Domain Entry Reader כדי לאפשר למשתמש לגלות ולהציג את דומיין הנתונים, את תת-הדומיינים שלו ואת המטא-נתונים של המשאבים הכלולים. אם רוצים להקצות עוד תפקידים, לוחצים על Add another role.

7. לוחצים על Save.

REST

כדי להגדיר את מדיניות ה-IAM בדומיין נתונים, משתמשים ב-method ‏projects.locations.dataDomains.setIamPolicy.

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

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

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

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

תוכן בקשת JSON:

{
  "policy": {
    "bindings": [
      {
        "role": "ROLE",
        "members": [
          "user:example-user@google.com",
          "group:finance-consumers@google.com"
        ]
      }
    ]
  }
}

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

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:setIamPolicy"

$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:setIamPolicy" | Select-Object -Expand Content

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

המסוף

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

   אל "דומיינים של נתונים"

2. לוחצים על שם הדומיין כדי לעבור לדף פרטי הדומיין.

3. בסרגל העליון, לוחצים על הרשאות.

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

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

6. לוחצים על Save.

REST

כדי לבטל גישה לדומיין נתונים באמצעות API בארכיטקטורת REST, מאחזרים את המדיניות הקיימת באמצעות ה-method‏ projects.locations.dataDomains.getIamPolicy, מסירים את התפקיד או את הישות המורשית מהרשימה bindings ומגדירים את המדיניות המעודכנת באמצעות ה-method‏ projects.locations.dataDomains.setIamPolicy:

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

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

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

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

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

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

   ‫Curl (Linux,‏ macOS או Cloud Shell)

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

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

   ‎PowerShell (Windows)

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

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID:getIamPolicy" | Select-Object -Expand Content

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

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

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

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

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

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

   תוכן בקשת JSON:

   {
     "policy": {
       "bindings": [
         {
           "role": "ROLE",
           "members": [
             "user:example-user@google.com",
             "group:finance-consumers@google.com"
           ]
         }
       ]
     }
   }
   

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

   ‫Curl (Linux,‏ macOS או Cloud Shell)

   שומרים את גוף הבקשה בקובץ בשם 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:setIamPolicy"

   ‎PowerShell (Windows)

   שומרים את גוף הבקשה בקובץ בשם 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:setIamPolicy" | Select-Object -Expand Content

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