Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Os modelos de configuração de grupo representam um conjunto de modelos a partir dos quais as configurações de grupo podem ser criadas e usadas em um locatário. Essa operação recupera a lista de objetos groupSettingTemplates disponíveis.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | GroupSettings.Read.All | Directory.Read.All, Directory.ReadWrite.All, GroupSettings.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | GroupSettings.Read.All | Directory.Read.All, Directory.ReadWrite.All, GroupSettings.ReadWrite.All |
Importante
Em cenários delegados com contas corporativas ou de estudante, o usuário conectado deve receber uma função do Microsoft Entra com suporte ou uma função personalizada com uma permissão de função com suporte. As funções menos privilegiadas a seguir têm suporte para essa operação.
- Administrador Local do Dispositivo Ingressado no Microsoft Entra - somente propriedades básicas
- Leitores de Diretório
- Leitor Global
Solicitação HTTP
GET /groupSettingTemplates
Parâmetros de consulta opcionais
Esse método dá suporte $select ao parâmetro de consulta OData para ajudar a personalizar a resposta.
Observação: $filter não é suportado.
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
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 200 OK e uma coleção de objetos groupSettingTemplate no corpo da resposta.
Exemplo
Solicitação
GET https://graph.microsoft.com/v1.0/groupSettingTemplates
Resposta
Observação: o objeto de resposta exibido aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettingTemplates",
"value": [
{
"id": "08d542b9-071f-4e16-94b0-74abb372e3d9",
"deletedDateTime": null,
"displayName": "Group.Unified.Guest",
"description": "Settings for a specific Unified Group",
"values": [
{
"name": "AllowToAddGuests",
"type": "System.Boolean",
"defaultValue": "true",
"description": "Flag indicating if guests are allowed in a specific Unified Group."
}
]
},
{
"id": "80661d51-be2f-4d46-9713-98a2fcaec5bc",
"deletedDateTime": null,
"displayName": "Prohibited Names Settings",
"description": "Setting templates define the different settings that can be used for the associated ObjectSettings. This template defines settings that can be used for managing tenant-wide prohibited names settings.",
"values": [
{
"name": "CustomBlockedSubStringsList",
"type": "System.String",
"defaultValue": "",
"description": "A comma delimited list of substring reserved words to block for application display names."
},
{
"name": "CustomBlockedWholeWordsList",
"type": "System.String",
"defaultValue": "",
"description": "A comma delimited list of reserved words to block for application display names."
}
]
}
]
}