Method: projects.locations.collections.dataStores.create

יצירת DataStore.

‫DataStore משמש לאחסון של Documents. כדי להציג את המסמכים האלה בחיפוש או בתרחיש לדוגמה של המלצה, צריך ליצור Engine בנפרד.

בקשת HTTP


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

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

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

פרמטרים
parent

string

חובה. שם משאב ההורה, למשל projects/{project}/locations/{location}/collections/{collection}.

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

פרמטרים
dataStoreId

string

חובה. המזהה לשימוש ב-DataStore, שיהפוך לרכיב הסופי של שם המשאב של DataStore.

השדה הזה צריך להיות בהתאם לתקן RFC-1034, עם מגבלת אורך של 63 תווים. אחרת, מוחזרת שגיאת INVALID_ARGUMENT.

skipDefaultSchemaCreation

boolean

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

אם המדיניות מוגדרת כ-True, צריך ליצור סכימה למאגר הנתונים באופן ידני לפני שאפשר להטמיע מסמכים.

אי אפשר לציין את הדגל הזה אם מציינים את הדגל dataStore.starting_schema.

אפשרויות CMEK ל-DataStore. הגדרת השדה הזה תבטל את ברירת המחדל של CmekConfig אם היא מוגדרת לפרויקט. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
cmekConfigName

string

שם המשאב של CmekConfig שמשמש להגנה על מאגר הנתונים הזה.

disableCmek

boolean

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

סוף השדות הבלעדיים.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של 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.dataStores.create

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