Excluir uma configuração de grupo

Namespace: microsoft.graph

Exclua um objeto groupSetting específico do locatário ou grupo.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global	Governo dos EUA L4	GOVERNO DOS EUA L5 (DOD)	China operada pela 21Vianet
✅	✅	✅	✅

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Para todas as configurações, exceto o objeto Configurações da Política de Consentimento

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Directory.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	Directory.ReadWrite.All

Para o objeto Configurações da Política de Consentimento

As permissões a seguir são necessárias para atualizar o objeto diretório "Configurações de Política de Consentimento" Setting .

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Policy.ReadWrite.Authorization
Delegado (conta pessoal da Microsoft)	Sem suporte.
Application	Policy.ReadWrite.Authorization

Para cenários delegados, o usuário de chamada precisa de pelo menos uma das seguintes funções de Microsoft Entra.

Microsoft Entra função	Privilégios permitidos
Microsoft Entra administrador local do dispositivo ingressado Leitores de Diretório Leitor Global	Ler propriedades básicas sobre configuração de modelos e configurações
Administrador de grupos Escritores de diretório	Gerenciar todas as configurações de grupo
Administrador de política de autenticação	Atualização Password Rule Settings
Administrador do usuário	Ler propriedades básicas sobre configuração de modelos e configurações Atualizar configurações

Solicitação HTTP

Exclua uma configuração em todo o locatário.

DELETE /groupSettings/{groupSettingId}

Exclua uma configuração específica do grupo.

DELETE /groups/{groupId}/settings/{groupSettingId}

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type	application/json

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se bem sucedido, este método retorna um código de resposta 204 No Content. Ele não retorna nada no corpo da resposta.

Exemplo

Solicitação

Neste exemplo, você exclui o objeto de configuração de grupo no nível do locatário.

HTTP

DELETE https://graph.microsoft.com/v1.0/groupSettings/{id}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.GroupSettings["{groupSetting-id}"].DeleteAsync();

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

CLI

// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc group-settings delete --group-setting-id {groupSetting-id}

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Ir

import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



graphClient.GroupSettings().ByGroupSettingId("groupSetting-id").Delete(context.Background(), nil)

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.groupSettings().byGroupSettingId("{groupSetting-id}").delete();

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/groupSettings/{id}')
	.delete();

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->groupSettings()->byGroupSettingId('groupSetting-id')->delete()->wait();

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Python

from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


await graph_client.group_settings.by_group_setting_id('groupSetting-id').delete()

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Resposta

HTTP/1.1 204 No Content