Définir les paramètres de mise à jour
Espace de noms: microsoft.graph
Mettez à jour un ou plusieurs paramètres au niveau du locataire pour SharePoint et OneDrive.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | SharePointTenantSettings.ReadWrite.All | Non disponible. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | SharePointTenantSettings.ReadWrite.All | Non disponible. |
Lors de l’appel au nom d’un utilisateur, l’utilisateur doit appartenir au rôle Administrateur SharePoint. Pour en savoir plus sur les rôles d’administrateur, consultez À propos des rôles d’administrateur dans le Centre d’administration Microsoft 365.
Requête HTTP
PATCH /admin/sharepoint/settings
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Content-Type | application/json. Obligatoire. |
Corps de la demande
Dans le corps de la demande, fournissez uniquement les valeurs des propriétés à mettre à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété.
Le tableau suivant spécifie les propriétés qui peuvent être mises à jour.
Propriété | Type | Description |
---|---|---|
allowedDomainGuidsForSyncApp | Collection GUID | Collection de GUID de domaine approuvé pour l’application Synchronisation OneDrive. |
deletedUserPersonalSiteRetentionPeriodInDays | Int32 | Nombre de jours pendant lesquels le OneDrive d’un utilisateur supprimé est conservé. |
excludedFileExtensionsForSyncApp | String collection | Collection d’extensions de fichier non chargées par l’application Synchronisation OneDrive. |
idleSessionSignOut | microsoft.graph.idleSessionSignOut | Spécifie les stratégies de déconnexion de session inactive pour le locataire. |
imageTaggingOption | imageTaggingChoice | Spécifie l’option d’étiquetage d’image pour le locataire. Les valeurs possibles sont disabled , basic et enhanced . |
isCommentingOnSitePagesEnabled | Valeur booléenne | Indique si les commentaires sont autorisés sur les pages de site modernes dans SharePoint. |
isFileActivityNotificationEnabled | Valeur booléenne | Indique si les notifications Push sont activées pour les événements OneDrive. |
isLegacyAuthProtocolsEnabled | Valeur booléenne | Indique si les protocoles d’authentification hérités sont activés pour le locataire. |
isLoopEnabled | Valeur booléenne | Indique si Fluid Framework est autorisé sur les sites SharePoint. |
isMacSyncAppEnabled | Valeur booléenne | Indique si les fichiers peuvent être synchronisés à l’aide de l’application Synchronisation OneDrive pour Mac. |
isRequireAcceptingUserToMatchInvitedUserEnabled | Valeur booléenne | Indique si les invités doivent se connecter à l’aide du compte auquel les invitations de partage sont envoyées. |
isResharingByExternalUsersEnabled | Valeur booléenne | Indique si les invités sont autorisés à repartager des fichiers, des dossiers et des sites dont ils ne sont pas propriétaires. |
isSharePointMobileNotificationEnabled | Valeur booléenne | Indique si les notifications Push mobiles sont activées pour SharePoint. |
isSharePointNewsfeedEnabled | Valeur booléenne | Indique si le flux d’actualités est autorisé sur les pages de site modernes dans SharePoint. |
isSiteCreationEnabled | Valeur booléenne | Indique si les utilisateurs sont autorisés à créer des sites. |
isSiteCreationUIEnabled | Valeur booléenne | Indique si les commandes d’interface utilisateur pour la création de sites sont affichées. |
isSitePagesCreationEnabled | Valeur booléenne | Indique si la création de pages modernes est autorisée sur les sites SharePoint. |
isSitesStorageLimitAutomatic | Valeur booléenne | Indique si l’espace de stockage du site est géré automatiquement ou si des limites de stockage spécifiques sont définies par site. |
isSyncButtonHiddenOnPersonalSite | Valeur booléenne | Indique si le bouton de synchronisation dans OneDrive est masqué. |
isUnmanagedSyncAppForTenantRestricted | Valeur booléenne | Indique si les utilisateurs sont autorisés à synchroniser des fichiers uniquement sur des PC joints à des domaines spécifiques. |
personalSiteDefaultStorageLimitInMB | Int64 | Limite de stockage OneDrive par défaut pour tous les utilisateurs nouveaux et existants auxquels une licence éligible est attribuée. Mesuré en mégaoctets (Mo). |
sharingAllowedDomainList | Collection de chaînes | Collection de domaines de messagerie autorisés pour le partage en dehors du organization. |
sharingBlockedDomainList | String collection | Collection de domaines de messagerie qui sont bloqués pour le partage en dehors du organization. |
sharingCapability | sharingCapabilities | Fonctionnalité de partage pour le locataire. Les valeurs possibles sont les suivantes : disabled , externalUserSharingOnly , externalUserAndGuestSharing , existingExternalUserSharingOnly . |
sharingDomainRestrictionMode | sharingDomainRestrictionMode | Spécifie le mode de partage externe pour les domaines. Les valeurs possibles sont none , allowList et blockList . |
siteCreationDefaultManagedPath | Chaîne | Valeur du chemin d’accès géré par le site d’équipe. Il s’agit du chemin sous lequel les nouveaux sites d’équipe seront créés. |
siteCreationDefaultStorageLimitInMB | Int32 | Quota de stockage par défaut pour un nouveau site lors de sa création. Mesuré en mégaoctets (Mo). |
tenantDefaultTimezone | Chaîne | Fuseau horaire par défaut d’un locataire pour les sites nouvellement créés. Pour obtenir la liste des valeurs possibles, consultez propriété SPRegionalSettings.TimeZones. |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK
code de réponse et un objet de paramètres mis à jour dans le corps de la réponse.
Exemples
Demande
L’exemple suivant illustre une demande.
PATCH https://graph.microsoft.com/v1.0/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
}
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
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)"
}