Method: projects.locations.dataAgents.createSync

יוצרת DataAgent חדש בפרויקט ובמיקום נתונים נתונים באופן סינכרוני.

בקשת HTTP

POST https://geminidataanalytics.googleapis.com/v1beta/{parent=projects/*/locations/*}/dataAgents:createSync

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. הערך של מאפיין ההורה.

פרמטרים של שאילתה

פרמטרים
dataAgentId

string

זה שינוי אופציונלי. המזהה של האובייקט ששולח את הבקשה. המזהה חייב להיות ייחודי במסגרת פריט האב. הפורמט המותר הוא: ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$. אם לא מספקים ערך, השרת יוצר ערך למזהה באופן אוטומטי.
requestId

string

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

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

מזהה הבקשה חייב להיות מזהה ייחודי אוניברסלי (UUID) תקין, למעט מזהה UUID אפס שלא נתמך (00000000-0000-0000-0000-000000000000).

גוף הבקשה

גוף הבקשה מכיל מופע של DataAgent.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של DataAgent.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

ניתן למצוא מידע נוסף כאן: Authentication Overview.

הרשאות IAM

נדרשת הרשאת IAM הבאה במשאב parent:

  • geminidataanalytics.dataAgents.create

מידע נוסף מופיע במאמרי העזרה בנושא IAM.