Method: projects.locations.instances.create

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

בקשת HTTP


POST https://memorystore.googleapis.com/v1alpha/{parent=projects/*/locations/*}/instances

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

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

פרמטרים
parent

string

חובה. משאב האב שבו תיווצר המכונה הזו. הפורמט: projects/{project}/locations/{location}

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

פרמטרים
instanceId

string

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

הערך הזה כפוף להגבלות הבאות:

  • האורך חייב להיות 4-63 תווים
  • חייב להתחיל באות או בספרה
  • השם חייב להכיל רק אותיות קטנות, ספרות ומקפים
  • לא יכול להסתיים במקף
  • חייב להיות ייחודי במיקום
requestId

string

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

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

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

הרשאות IAM

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

  • memorystore.instances.create

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