Method: folders.settings.value.create
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יוצרת ערך הגדרה.
הפונקציה מחזירה google.rpc.Status עם google.rpc.Code.NOT_FOUND אם ההגדרה לא קיימת. הפונקציה מחזירה google.rpc.Status עם google.rpc.Code.ALREADY_EXISTS אם ערך ההגדרה כבר קיים במשאב Cloud הנתון. מחזירה google.rpc.Status עם google.rpc.Code.FAILED_PRECONDITION אם ההגדרה מסומנת כקריאה בלבד.
בקשת HTTP
POST https://resourcesettings.googleapis.com/v1alpha1/{settingValue.name=folders/*/settings/*/value}
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים |
settingValue.name |
string
שם המשאב של ערך ההגדרה. הערך חייב להיות באחד מהפורמטים הבאים:
projects/{project_number}/settings/{setting_name}/valuefolders/{folder_id}/settings/{setting_name}/valueorganizations/{organization_id}/settings/{setting_name}/value לדוגמה, /projects/123/settings/gcp-enableMyFeature/value
|
גוף הבקשה
גוף הבקשה מכיל מופע של SettingValue.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של SettingValue.
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/cloud-platform
מידע נוסף זמין במאמר סקירה כללית על אימות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["Creates a new setting value for a specific Cloud resource (project, folder, or organization)."],["Returns errors if the setting doesn't exist, the value already exists, or the setting is read-only."],["Requires `cloud-platform` OAuth scope for authorization."],["Uses the SettingValue resource for both request and response bodies, providing details on the setting value being created."],["Employs gRPC Transcoding for HTTP requests to interact with the Resource Settings API."]]],["This outlines creating a setting value via a POST request to a specified URL. The URL structure includes path parameters that define the resource name, such as projects, folders, or organizations. The request body carries the `SettingValue` data, and a successful response returns a new `SettingValue` instance. Errors, like non-existent settings or existing values, are indicated via `google.rpc.Status`. The operation requires OAuth scope `https://www.googleapis.com/auth/cloud-platform`.\n"]]
