Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Las plantillas de configuración de grupo representan un conjunto de plantillas a partir de las cuales se puede crear y usar la configuración de grupo dentro de un inquilino. Esta operación recupera la lista de objetos groupSettingTemplates disponibles.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | GroupSettings.Read.All | Directory.Read.All, Directory.ReadWrite.All, GroupSettings.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | GroupSettings.Read.All | Directory.Read.All, Directory.ReadWrite.All, GroupSettings.ReadWrite.All |
Importante
En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido. Se admiten los siguientes roles con privilegios mínimos para esta operación.
- Microsoft Entra administrador local de dispositivos unidos: solo propiedades básicas
- Lectores de directorio
- Lector global
Solicitud HTTP
GET /groupSettingTemplates
Parámetros de consulta opcionales
Este método admite el $selectparámetro de consulta OData para ayudar a personalizar la respuesta.
Nota: No se admite $filter.
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y la colección de objetos groupSettingTemplate en el cuerpo de la respuesta.
Ejemplo
Solicitud
GET https://graph.microsoft.com/v1.0/groupSettingTemplates
Respuesta
Nota: el objeto de respuesta que se muestra aquí puede haberse acortado para mejorar la legibilidad.
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."
}
]
}
]
}