Method: projects.locations.dataStores.controls.create

יוצר אמצעי בקרה.

כברירת מחדל, אפשר להגדיר עד 1,000 אמצעי בקרה למאגר נתונים. אפשר לשלוח בקשה לשינוי המגבלה הזו. אם Control שרוצים ליצור כבר קיים, מוחזרת השגיאה ALREADY_EXISTS.

בקשת HTTP

POST https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*/dataStores/*}/controls

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

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

פרמטרים
parent

string

חובה. השם המלא של משאב מאגר הנתונים הראשי. פורמט: projects/{project}/locations/{location}/collections/{collectionId}/dataStores/{dataStoreId} או projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}.

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

פרמטרים
controlId

string

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

הערך צריך להיות באורך של 1-63 תווים. התווים התקינים הם ‎ /[a-z][0-9]-_/.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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

הרשאות IAM

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

  • discoveryengine.controls.create

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