Actualizar configuración

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)"
}