Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Обновите один или несколько параметров на уровне клиента для SharePoint и OneDrive.
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | SharePointTenantSettings.ReadWrite.All | Недоступно. |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Приложение | SharePointTenantSettings.ReadWrite.All | Недоступно. |
При вызове от имени пользователя пользователь должен принадлежать к роли администратора SharePoint. Дополнительные сведения о ролях администраторов см. в разделе Сведения о ролях администраторов в Центр администрирования Microsoft 365.
HTTP-запрос
PATCH /admin/sharepoint/settings
Заголовки запросов
| Имя | Описание |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
| Content-Type | application/json. Обязательно. |
Текст запроса
В тексте запроса укажите только значения свойств для обновления. Существующие свойства, которые не включены в текст запроса, сохраняют свои предыдущие значения или пересчитываются на основе изменений других значений свойств.
В следующей таблице указаны свойства, которые можно обновить.
| Свойство | Тип | Описание |
|---|---|---|
| allowedDomainGuidsForSyncApp | Коллекция идентификаторов GUID | Коллекция идентификаторов GUID доверенного домена для приложения приложение синхронизации OneDrive. |
| deletedUserPersonalSiteRetentionPeriodInDays | Int32 | Количество дней для сохранения oneDrive удаленного пользователя. |
| excludedFileExtensionsForSyncApp | Коллекция строк | Коллекция расширений файлов, не переданных приложением приложение синхронизации OneDrive. |
| idleSessionSignOut | microsoft.graph.idleSessionSignOut | Указывает политики выхода сеанса бездействия для клиента. |
| imageTaggingOption | imageTaggingChoice | Указывает параметр тегов изображений для клиента. Допустимые значения: disabled, basic, enhanced. |
| isCommentingOnSitePagesEnabled | Логический | Указывает, разрешены ли комментарии на современных страницах сайта в SharePoint. |
| isFileActivityNotificationEnabled | Логический | Указывает, включены ли push-уведомления для событий OneDrive. |
| isLegacyAuthProtocolsEnabled | Логический | Указывает, включены ли устаревшие протоколы проверки подлинности для клиента. |
| isLoopEnabled | Логический | Указывает, разрешена ли Fluid Framework на сайтах SharePoint. |
| isMacSyncAppEnabled | Логический | Указывает, можно ли синхронизировать файлы с помощью приложения приложение синхронизации OneDrive для Mac. |
| isRequireAcceptingUserToMatchInvitedUserEnabled | Логический | Указывает, должны ли гости входить в систему с помощью той же учетной записи, в которую отправляются приглашения на общий доступ. |
| isResharingByExternalUsersEnabled | Логический | Указывает, разрешено ли гостям повторно делиться файлами, папками и сайтами, которыми они не владеют. |
| isSharePointMobileNotificationEnabled | Логический | Указывает, включены ли мобильные push-уведомления для SharePoint. |
| isSharePointNewsfeedEnabled | Логический | Указывает, разрешен ли канал новостей на современных страницах сайта в SharePoint. |
| isSiteCreationEnabled | Логический | Указывает, разрешено ли пользователям создавать сайты. |
| isSiteCreationUIEnabled | Логический | Указывает, отображаются ли команды пользовательского интерфейса для создания сайтов. |
| isSitePagesCreationEnabled | Логический | Указывает, разрешено ли создание новых современных страниц на сайтах SharePoint. |
| isSitesStorageLimitAutomatic | Логический | Указывает, осуществляется ли автоматическое управление объемом хранилища сайта или установлены ли определенные ограничения хранилища для каждого сайта. |
| isSyncButtonHiddenOnPersonalSite | Логический | Указывает, скрыта ли кнопка синхронизации в OneDrive. |
| isUnmanagedSyncAppForTenantRestricted | Логический | Указывает, разрешено ли пользователям синхронизировать файлы только на компьютерах, присоединенных к определенным доменам. |
| personalSiteDefaultStorageLimitInMB | Int64 | Ограничение хранилища OneDrive по умолчанию для всех новых и существующих пользователей, которым назначена лицензирование. Измеряется в мегабайтах (МБ). |
| sharingAllowedDomainList | Коллекция строк | Коллекция доменов электронной почты, которым разрешено предоставлять общий доступ за пределами организации. |
| sharingBlockedDomainList | Коллекция строк | Коллекция доменов электронной почты, которые заблокированы для общего доступа за пределами организации. |
| sharingCapability | sharingCapabilities | Возможность совместного использования для клиента. Допустимые значения: disabled, externalUserSharingOnly, externalUserAndGuestSharing, existingExternalUserSharingOnly. |
| sharingDomainRestrictionMode | sharingDomainRestrictionMode | Указывает режим внешнего совместного доступа для доменов. Допустимые значения: none, allowList, blockList. |
| siteCreationDefaultManagedPath | String | Значение управляемого пути сайта группы. Это путь, по которому будут создаваться новые сайты групп. |
| siteCreationDefaultStorageLimitInMB | Int32 | Квота хранилища по умолчанию для нового сайта после создания. Измеряется в мегабайтах (МБ). |
| tenantDefaultTimezone | String | Часовой пояс клиента по умолчанию для вновь созданных сайтов. Список возможных значений см. в разделе Свойство SPRegionalSettings.TimeZones. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект settings в тексте ответа.
Примеры
Запрос
Ниже показан пример запроса.
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
}
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
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)"
}