Atualizar diretórioDefinição
Namespace: microsoft.graph
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Atualize as propriedades de um objeto de definição de diretório 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
As tabelas seguintes mostram as permissões ou permissões com menos privilégios necessárias para chamar esta API em cada tipo de recurso suportado. Siga as melhores práticas para pedir permissões com menos privilégios. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
Para todas as definições , exceto o objeto Definições de Política de Consentimento
Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
---|---|---|
Delegado (conta corporativa ou de estudante) | Directory.ReadWrite.All | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Directory.ReadWrite.All | Indisponível. |
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 com menos privilégios | Permissões com privilégios superiores |
---|---|---|
Delegado (conta corporativa ou de estudante) | Policy.ReadWrite.Authorization | Directory.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | Policy.ReadWrite.Authorization | Directory.ReadWrite.All |
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
Atualizar uma definição ao nível do inquilino.
PATCH /settings/{directorySettingId}
Atualizar uma definição específica do grupo.
PATCH /groups/{groupId}/settings/{directorySettingId}
Cabeçalhos de solicitação opcionais
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados.
Propriedade | Tipo | Descrição |
---|---|---|
values | settingValue collection | O conjunto atualizado de valores. NOTA: tem de fornecer todo o conjunto de coleções. Não pode atualizar um único conjunto de valores. |
Resposta
Se tiver êxito, este método retornará um código de resposta 204 No Content
.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
PATCH https://graph.microsoft.com/beta/settings/3c105fc3-2254-4861-9e2d-d59e2126f3ef
Content-type: application/json
{
"values": [
{
"name": "CustomBlockedWordsList",
"value": "Contoso"
}
]
}
Resposta
HTTP/1.1 204 No Content