Method: folders.settings.deleteValue
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Exclui um valor de configuração. Se o valor da configuração não existir, a operação não fará nada.
Retorna um google.rpc.Status
com google.rpc.Code.NOT_FOUND
se a configuração ou o valor dela não existir. O valor da configuração não vai existir se uma chamada anterior para DeleteSetting
já tiver retornado um código de sucesso. Retorna um google.rpc.Status
com google.rpc.Code.FAILED_PRECONDITION
se a configuração for sinalizada como somente leitura.
Solicitação HTTP
DELETE https://resourcesettings.googleapis.com/v1alpha1/{name=folders/*/settings/*/value}
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros |
name |
string
O nome do valor de configuração a ser excluído. Consulte SettingValue para saber mais sobre os requisitos de nomenclatura.
A autorização requer a seguinte permissão do IAM no recurso especificado name :
resourcesettings.settingvalues.delete
|
Parâmetros de consulta
Parâmetros |
ignoreReadOnly |
boolean
Uma flag que permite a exclusão do valor de uma configuração readOnly . AVISO: use por sua conta e risco. A exclusão do valor de uma configuração somente leitura é uma ação irreversível, ou seja, não é possível criar o valor novamente.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se bem-sucedido, o corpo da resposta ficará vazio.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/cloud-platform
Para saber mais, consulte a Visão geral da autenticação.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-25 UTC."],[[["Deletes a setting value; if the setting value does not exist, it's a no-op."],["Returns a `google.rpc.Status` with `google.rpc.Code.NOT_FOUND` or `google.rpc.Code.FAILED_PRECONDITION` under certain conditions."],["Uses DELETE HTTP request with gRPC Transcoding syntax."],["Requires `resourcesettings.settingvalues.delete` IAM permission and `https://www.googleapis.com/auth/cloud-platform` OAuth scope."]]],["This document details the process of deleting a setting value via a `DELETE` HTTP request to the specified URL, including path and query parameters. The operation is a no-op if the value doesn't exist. Success returns an empty response, while non-existence or read-only status yields specific `google.rpc.Status` codes. The request body must be empty. Authorization requires specific IAM permissions and OAuth scope. A query parameter allows deleting read-only values with a warning.\n"]]