AI-generated Key Takeaways
-
Deletes a setting value; if the setting value is already deleted or does not exist, it's considered successful.
-
Returns an error if the setting is read-only or the setting/setting value is not found.
-
The request body must be empty for this DELETE request.
-
Requires
resourcesettings.settingvalues.delete
IAM permission andhttps://www.googleapis.com/auth/cloud-platform
OAuth scope.
Deletes a setting value. If the setting value does not exist, the operation is a no-op.
Returns a google.rpc.Status
with google.rpc.Code.NOT_FOUND
if the setting or the setting value does not exist. The setting value will not exist if a prior call to DeleteSetting
for the setting value already returned a success code. Returns a google.rpc.Status
with google.rpc.Code.FAILED_PRECONDITION
if the setting is flagged as read only.
HTTP request
DELETE https://resourcesettings.googleapis.com/v1alpha1/{name=projects/*/settings/*/value}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
name |
The name of the setting value to delete. See Authorization requires the following IAM permission on the specified resource
|
Query parameters
Parameters | |
---|---|
ignoreReadOnly |
A flag that allows the deletion of the value of a |
Request body
The request body must be empty.
Response body
If successful, the response body will be empty.
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.