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
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Actualice una o varias opciones de configuración de nivel de inquilino para SharePoint y OneDrive.
Esta API está disponible en las siguientes implementaciones en la nube nacional.
| Servicio global | Administración pública de EE. UU. | Gobierno de EE. UU. L5 (DOD) | China operado por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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) | SharePointTenantSettings.ReadWrite.All | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | SharePointTenantSettings.ReadWrite.All | No disponible. |
Al llamar en nombre de un usuario, el usuario debe pertenecer al rol Administrador de SharePoint. Para obtener más información acerca de los roles de administrador, vea Acerca de los roles de administrador en el Centro de administración de Microsoft 365.
Solicitud HTTP
PATCH /admin/sharepoint/settings
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización. |
| Content-Type | application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione solo los valores de las propiedades que se van a actualizar. Las propiedades existentes que no están incluidas en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad.
En la tabla siguiente se especifican las propiedades que se pueden actualizar.
| Propiedad | Tipo | Descripción |
|---|---|---|
| allowedDomainGuidsForSyncApp | Colección de GUID | Colección de GUID de dominio de confianza para la aplicación de sincronización de OneDrive. |
| deletedUserPersonalSiteRetentionPeriodInDays | Int32 | El número de días para conservar el OneDrive de un usuario eliminado. |
| excludedFileExtensionsForSyncApp | Colección string | Colección de extensiones de archivo no cargadas por la aplicación de sincronización de OneDrive. |
| idleSessionSignOut | microsoft.graph.idleSessionSignOut | Especifica las directivas de cierre de sesión de sesión inactivas para el inquilino. |
| imageTaggingOption | imageTaggingChoice | Especifica la opción de etiquetado de imágenes para el inquilino. Los valores posibles son: disabled, basic, enhanced. |
| isCommentingOnSitePagesEnabled | Booleano | Indica si se permiten comentarios en páginas de sitio modernas en SharePoint. |
| isFileActivityNotificationEnabled | Booleano | Indica si las notificaciones de inserción están habilitadas para eventos de OneDrive. |
| isLegacyAuthProtocolsEnabled | Booleano | Indica si están habilitados los protocolos de autenticación heredados para el inquilino. |
| isLoopEnabled | Booleano | Indica si Fluid Framework está permitido en los sitios de SharePoint. |
| isMacSyncAppEnabled | Booleano | Indica si los archivos se pueden sincronizar mediante la aplicación de sincronización de OneDrive para Mac. |
| isRequireAcceptingUserToMatchInvitedUserEnabled | Booleano | Indica si los invitados deben iniciar sesión con la misma cuenta a la que se envían las invitaciones para uso compartido. |
| isResharingByExternalUsersEnabled | Booleano | Indica si los invitados pueden volver a compartir archivos, carpetas y sitios que no son de su propiedad. |
| isSharePointMobileNotificationEnabled | Booleano | Indica si las notificaciones de inserción móviles están habilitadas para SharePoint. |
| isSharePointNewsfeedEnabled | Booleano | Indica si la fuente de noticias está permitida en las páginas del sitio moderno en SharePoint. |
| isSiteCreationEnabled | Booleano | Indica si los usuarios pueden crear sitios. |
| isSiteCreationUIEnabled | Booleano | Indica si se muestran los comandos de la interfaz de usuario para crear sitios. |
| isSitePagesCreationEnabled | Booleano | Indica si se permite la creación de nuevas páginas modernas en los sitios de SharePoint. |
| isSitesStorageLimitAutomatic | Booleano | Indica si el espacio de almacenamiento del sitio se administra automáticamente o si se establecen límites de almacenamiento específicos por sitio. |
| isSyncButtonHiddenOnPersonalSite | Booleano | Indica si el botón de sincronización de OneDrive está oculto. |
| isUnmanagedSyncAppForTenantRestricted | Booleano | Indica si los usuarios pueden sincronizar archivos solo en equipos unidos a dominios específicos. |
| personalSiteDefaultStorageLimitInMB | Int64 | El límite de almacenamiento predeterminado de OneDrive para todos los usuarios nuevos y existentes a los que se les asigne una licencia cualificada. Medido en megabytes (MB). |
| sharingAllowedDomainList | Colección string | Recopilación de dominios de correo electrónico que se pueden compartir fuera de la organización. |
| sharingBlockedDomainList | Colección string | Colección de dominios de correo electrónico bloqueados para compartir fuera de la organización. |
| sharingCapability | sharingCapabilities | Capacidad de uso compartido para el espacio empresarial. Los valores posibles son: disabled, externalUserSharingOnly, externalUserAndGuestSharing y existingExternalUserSharingOnly |
| sharingDomainRestrictionMode | sharingDomainRestrictionMode | Especifica el modo compartido externo para los dominios. Los valores posibles son: none, allowList, blockList. |
| siteCreationDefaultManagedPath | Cadena | El valor de la ruta administrada del sitio de grupo. Esta es la ruta de acceso en la que se crearán los nuevos sitios de grupo. |
| siteCreationDefaultStorageLimitInMB | Int32 | La cuota de almacenamiento predeterminada para un nuevo sitio tras la creación. Medido en megabytes (MB). |
| tenantDefaultTimezone | Cadena | La zona horaria predeterminada de un inquilino para los sitios recién creados. Para obtener una lista de los valores posibles, vea la propiedad SPRegionalSettings.TimeZones. |
Respuesta
Si tiene éxito, este método devuelve un código de 200 OK respuesta y un objeto de configuración actualizado en el cuerpo de la respuesta.
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
PATCH https://graph.microsoft.com/beta/admin/sharepoint/settings
Content-Type: application/json
Content-length: 1323
{
"deletedUserPersonalSiteRetentionPeriodInDays": 365,
"excludedFileExtensionsForSyncApp": [".mp3"],
"imageTaggingOption": "enhanced",
"isLegacyAuthProtocolsEnabled": true,
"isSitesStorageLimitAutomatic": false,
"isSyncButtonHiddenOnPersonalSite": false,
"isUnmanagedSyncAppForTenantRestricted": false,
"personalSiteDefaultStorageLimitInMB": 120000
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.sharepointSettings",
"allowedDomainGuidsForSyncApp": [
"bdd1ab9b-3fd0-4def-a761-ec8d7471732c",
"ad31vb6b-5zd0-7tyg-m231-kj8d6578432c"
],
"availableManagedPathsForSiteCreation": [
"/sites/",
"/teams/"
],
"deletedUserPersonalSiteRetentionPeriodInDays": 365,
"excludedFileExtensionsForSyncApp": [
".mp3"
],
"idleSessionSignOut": {
"isEnabled": true,
"warnAfterInSeconds": 120,
"signOutAfterInSeconds": 300
},
"imageTaggingOption": "basic",
"isCommentingOnSitePagesEnabled": true,
"isFileActivityNotificationEnabled": true,
"isLegacyAuthProtocolsEnabled": true,
"isLoopEnabled": true,
"isMacSyncAppEnabled": false,
"isRequireAcceptingUserToMatchInvitedUserEnabled": true,
"isResharingByExternalUsersEnabled": true,
"isSharePointMobileNotificationEnabled": true,
"isSharePointNewsfeedEnabled": true,
"isSiteCreationEnabled": true,
"isSiteCreationUIEnabled": true,
"isSitePagesCreationEnabled": true,
"isSitesStorageLimitAutomatic": false,
"isSyncButtonHiddenOnPersonalSite": false,
"isUnmanagedSyncAppForTenantRestricted": false,
"personalSiteDefaultStorageLimitInMB": 120000,
"sharingAllowedDomainList" : [
"contoso.com",
"fabrikam.com"
],
"sharingBlockedDomainList" : [
"contoso.com",
"fabrikam.com"
],
"sharingCapability": "externalUserAndGuestSharing",
"sharingDomainRestrictionMode": "allowList",
"siteCreationDefaultManagedPath": "/sites/",
"siteCreationDefaultStorageLimitInMB": 808034,
"tenantDefaultTimezone": "(UTC-05:00) Eastern Time (US and Canada)"
}