REST Resource: folders.settings

    • Settings define configurable values for Cloud resources, with each resource having at most one value per setting.

    • Settings have properties like name, display name, description, data type, and a potential default value.

    • Available data types for settings include boolean, string, and string set.

    • Resource Settings provide methods to manage setting values, such as retrieving, updating, deleting, and searching for them.

    • You can also determine the effective value of a setting, which considers inheritance and defaults.

    Resource: Setting

    The schema for setting values. At a given Cloud resource, a setting can parent at most one setting value.

    JSON representation 
     { 
 "name" 
 : 
 string 
 , 
 "displayName" 
 : 
 string 
 , 
 "description" 
 : 
 string 
 , 
 "readOnly" 
 : 
 boolean 
 , 
 "dataType" 
 : 
 enum (  DataType 
 
) 
 , 
 "defaultValue" 
 : 
 { 
 object (  Value 
 
) 
 } 
 }
    Fields
    name

    string

    The resource name of the setting. Must be in one of the following forms:

    • projects/{project_number}/settings/{setting_name}
    • folders/{folder_id}/settings/{setting_name}
    • organizations/{organization_id}/settings/{setting_name}

    For example, "/projects/123/settings/gcp-enableMyFeature"

    displayName

    string

    The human readable name for this setting.

    description

    string

    A detailed description of what this setting does.

    readOnly

    boolean

    A flag indicating that values of this setting cannot be modified (see documentation of the specific setting for updates and reasons); however, it may be deleted using settings.deleteValue if DeleteSettingValueRequest.ignore_read_only is set to true. Using this flag is considered an acknowledgement that the setting value cannot be recreated. See DeleteSettingValueRequest.ignore_read_only for more details.

    dataType

    enum ( DataType )

    The data type for this setting.

    defaultValue

    object ( Value )

    The value received by settings.lookupEffectiveValue if no setting value is explicitly set.

    Note: not all settings have a default value.

    DataType

    The data type for setting values of this setting. See Value for more details on the available data types.

    Enums
    DATA_TYPE_UNSPECIFIED Unspecified data type.
    BOOLEAN A boolean setting.
    STRING A string setting.
    STRING_SET A string set setting.

    Methods

    deleteValue

    		Deletes a setting value.

    getValue

    		Gets a setting value.

    list

    		Lists all the settings that are available on the Cloud resource parent .

    lookupEffectiveValue

    		Computes the effective setting value of a setting at the Cloud resource parent .
    Searches for all setting values that exist on the resource parent .

    updateValue

    		Updates a setting value.
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: