Method: projects.locations.instances.patch

מעדכן את הפרמטרים של מופע יחיד.

בקשת HTTP


PATCH https://memorystore.googleapis.com/v1beta/{instance.name=projects/*/locations/*/instances/*}

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

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

פרמטרים
instance.name

string

מזהה. השם הייחודי של המופע. פורמט: projects/{project}/locations/{location}/instances/{instance}

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

פרמטרים
updateMask

string (FieldMask format)

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

זוהי רשימה של שמות שדות שמוגדרים במלואם, שמופרדים באמצעות פסיקים. דוגמה: "user.displayName,photo"
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 הבאה במשאב name:

  • memorystore.instances.update

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