Excluir uma configuração de grupo

Namespace: microsoft.graph

Eliminar um objeto groupSetting ao nível do inquilino ou de grupo específico.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government 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.

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

São necessárias as seguintes permissões para atualizar o objeto de definições de definição "Definições de 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) Policy.ReadWrite.Authorization
Delegado (conta pessoal da Microsoft) Sem suporte.
Application Policy.ReadWrite.Authorization

Importante

Em cenários delegados com contas escolares ou profissionais, o utilizador com sessão iniciada tem de ter uma função de Microsoft Entra suportada ou uma função personalizada com uma permissão de função suportada. As seguintes funções com menos privilégios são suportadas para esta operação.

  • Leia as propriedades básicas sobre a definição de modelos e definições - Microsoft Entra Administrador Local do Dispositivo Associado, Leitores de Diretórios, Leitor Global
  • Gerir todas as definições de grupo/diretório - Escritores de Diretórios
  • Gerir definições globais e locais para grupos; gerir Group.Unified.Guest e Group.Unified definições - administrador do Grupos
  • Atualização Password Rule Settings – Administrador de Políticas de Autenticação
  • Atualizar definições, Ler propriedades básicas na definição de modelos e definições – Administrador de Utilizadores

Solicitação HTTP

Eliminar uma definição ao nível do inquilino.

DELETE /groupSettings/{groupSettingId}

Eliminar uma definiçã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. Não devolve nada no corpo da resposta.

Exemplo

Solicitação

Neste exemplo, irá eliminar o objeto de definição de grupo ao nível do inquilino.

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

Resposta

HTTP/1.1 204 No Content