Method: projects.locations.dataStores.create

יצירת מאגר נתונים חדש בפרויקט ובמיקום נתונים.

האוסף התומך של DataStore (ראו DataStore.collection_name) נוצר יחד איתו. הבקשה נכשלת עם FAILED_PRECONDITION אם כבר קיים אוסף עם המזהה הזה, למשל אוסף שנשמר כשמאגר נתונים קודם עם אותו מזהה נמחק בלי backingCollectionDeleted.

בקשת HTTP

POST https://vectorsearch.googleapis.com/v1beta/{parent}/dataStores

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

פרמטרים
parent

string

חובה. ערך להורה.

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

פרמטרים
dataStoreId

string

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

string

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

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

מזהה הבקשה חייב להיות UUID תקין, אבל אין תמיכה ב-UUID עם אפסים (00000000-0000-0000-0000-000000000000).

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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