Method: projects.locations.collections.dataStores.controls.create

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

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

בקשת HTTP


POST https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*/collections/*/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
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

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

הרשאות IAM

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

  • discoveryengine.controls.create

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