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.
Para todas as definições, exceto o objeto 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) | Directory.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. |
Aplicativo | Directory.ReadWrite.All |
Para o objeto Definições de Política de Consentimento
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
eGroup.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