Method: projects.locations.loggingSettings.settingBindings.patch

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

בקשת HTTP

PATCH https://cloudaicompanion.googleapis.com/v1/{settingBinding.name=projects/*/locations/*/loggingSettings/*/settingBindings/*}

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

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

פרמטרים
settingBinding.name

string

מזהה. שם המשאב. Format:projects/{project}/locations/{location}/{settingType}/{setting}/settingBindings/{settingBinding}

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

פרמטרים
updateMask

string (FieldMask format)

זה שינוי אופציונלי. מסכת השדות משמשת לציון השדות שעליהם יתבצע כתיבה מחדש במשאב SettingBinding במסגרת העדכון. השדות שצוינו ב-updateMask הם יחסיים למשאב, ולא לבקשה המלאה. שדה יוחלף אם הוא נמצא במסכה. אם המשתמש לא יספק מסכה, כל השדות שבבקשה יימחקו.

זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"
requestId

string

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

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

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

נדרשת הרשאת OAuth ברמה הבאה:

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

מידע נוסף זמין בAuthentication Overview.

הרשאות IAM

נדרשת ההרשאה הבאה ב-IAM במשאב name:

  • cloudaicompanion.settingBindings.loggingSettingsUpdate

נדרשת ההרשאה הבאה ב-IAM במשאב target:

  • cloudaicompanion.settingBindings.loggingSettingsUse

למידע נוסף, עיינו במסמכי העזרה של IAM.