Method: organizations.settings.deleteValue

Löscht einen Einstellungswert. Wenn der Einstellungswert nicht vorhanden ist, wird der Vorgang nicht ausgeführt.

Gibt ein google.rpc.Status mit google.rpc.Code.NOT_FOUND zurück, wenn die Einstellung oder der Einstellungswert nicht vorhanden ist. Der Einstellungs-Wert ist nicht vorhanden, wenn bei einem vorherigen Aufruf von DeleteSetting für den Einstellungs-Wert bereits ein Erfolgscode zurückgegeben wurde. Gibt ein google.rpc.Status mit google.rpc.Code.FAILED_PRECONDITION zurück, wenn die Einstellung als schreibgeschützt gekennzeichnet ist.

HTTP-Anfrage

DELETE https://resourcesettings.googleapis.com/v1alpha1/{name=organizations/*/settings/*/value}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Der Name des zu löschenden Einstellungs-Werts. Informationen zu den Benennungsanforderungen finden Sie unter SettingValue.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • resourcesettings.settingvalues.delete

Suchparameter

Parameter
ignoreReadOnly

boolean

Ein Flag, mit dem der Wert einer readOnly-Einstellung gelöscht werden kann. WARNUNG: Die Nutzung erfolgt auf eigenes Risiko. Das Löschen des Werts einer schreibgeschützten Einstellung ist eine irreversible Aktion, d.h., der Wert kann nicht noch einmal erstellt werden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.