Atualizar configurações
Namespace: microsoft.graph
Atualize uma ou mais configurações de nível de locatário para SharePoint e OneDrive.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | SharePointTenantSettings.ReadWrite.All | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | SharePointTenantSettings.ReadWrite.All | Indisponível. |
Ao chamar em nome de um usuário, o usuário precisa pertencer a uma das funções de administrador a seguir. Para saber mais sobre funções de administrador, consulte Sobre funções de administrador no Centro de administração do Microsoft 365:
- Administrador Global
- Administrador do SharePoint
Solicitação HTTP
PATCH /admin/sharepoint/settings
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Content-Type | application/json. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça apenas os valores das propriedades que devem ser atualizadas. As propriedades existentes que não estão incluídas no corpo da solicitação mantêm seus valores anteriores ou são recalculadas com base em alterações em outros valores de propriedade.
A tabela a seguir especifica as propriedades que podem ser atualizadas.
Propriedade | Tipo | Descrição |
---|---|---|
allowedDomainGuidsForSyncApp | Coleção de GUIDs | Coleção de GUIDs de domínio confiáveis para o aplicativo Sincronização do OneDrive. |
deletedUserPersonalSiteRetentionPeriodInDays | Int32 | O número de dias para preservar o OneDrive de um usuário excluído. |
excludeedFileExtensionsForSyncApp | Coleção de cadeias de caracteres | Coleção de extensões de arquivo não carregadas pelo aplicativo Sincronização do OneDrive. |
idleSessionSignOut | microsoft.graph.idleSessionSignOut | Especifica as políticas de saída de sessão ociosas para o locatário. |
imageTaggingOption | imageTaggingChoice | Especifica a opção de marcação de imagem para o locatário. Os valores possíveis são: disabled , basic , enhanced . |
isCommentingOnSitePagesEnabled | Booliano | Indica se os comentários são permitidos em páginas de sites modernas no SharePoint. |
isFileActivityNotificationEnabled | Booliano | Indica se as notificações por push estão habilitadas para eventos do OneDrive. |
isLegacyAuthProtocolsEnabled | Booliano | Indica se os protocolos de autenticação herdados estão habilitados para o locatário. |
isLoopEnabled | Booliano | Indica se o Fluid Framework é permitido em sites do SharePoint. |
isMacSyncAppEnabled | Booliano | Indica se os arquivos podem ser sincronizados usando o aplicativo Sincronização do OneDrive para Mac. |
isRequireAcceptingUserToMatchInvitedUserEnabled | Booliano | Indica se os convidados devem entrar usando a mesma conta para a qual os convites de compartilhamento são enviados. |
isResharingByExternalUsersEnabled | Booliano | Indica se os convidados têm permissão para recompartilhar arquivos, pastas e sites que não possuem. |
isSharePointMobileNotificationEnabled | Booliano | Indica se as notificações por push móvel estão habilitadas para o SharePoint. |
isSharePointNewsfeedEnabled | Booliano | Indica se o feed de notícias é permitido nas páginas modernas do site no SharePoint. |
isSiteCreationEnabled | Booliano | Indica se os usuários têm permissão para criar sites. |
isSiteCreationUIEnabled | Booliano | Indica se os comandos da interface do usuário para criar sites são mostrados. |
isSitePagesCreationEnabled | Booliano | Indica se a criação de novas páginas modernas é permitida em sites do SharePoint. |
isSitesStorageLimitAutomatic | Booliano | Indica se o espaço de armazenamento do site é gerenciado automaticamente ou se os limites de armazenamento específicos são definidos por site. |
isSyncButtonHiddenOnPersonalSite | Booliano | Indica se o botão de sincronização no OneDrive está oculto. |
isUnmanagedSyncAppForTenantRestricted | Booliano | Indica se os usuários têm permissão para sincronizar arquivos apenas em PCs ingressados em domínios específicos. |
personalSiteDefaultStorageLimitInMB | Int64 | O limite de armazenamento do OneDrive padrão para todos os usuários novos e existentes que recebem uma licença de qualificação. Medido em megabytes (MB). |
sharingAllowedDomainList | String collection | Coleção de domínios de email permitidos para compartilhamento fora da organização. |
sharingBlockedDomainList | String collection | Coleção de domínios de email bloqueados para compartilhamento fora da organização. |
sharingCapability | sharingCapabilities | Capacidade de compartilhamento para o locatário. Os valores possíveis são: disabled , externalUserSharingOnly , externalUserAndGuestSharing , existingExternalUserSharingOnly . |
sharingDomainRestrictionMode | sharingDomainRestrictionMode | Especifica o modo compartilhamento externo para os domínios. Os valores possíveis são: none , allowList , blockList . |
siteCreationDefaultManagedPath | Cadeia de caracteres | O valor do caminho gerenciado pelo site da equipe. Esse é o caminho no qual novos sites de equipe serão criados. |
siteCreationDefaultStorageLimitInMB | Int32 | A cota de armazenamento padrão para um novo site após a criação. Medido em megabytes (MB). |
tenantDefaultTimezone | Cadeia de caracteres | O fuso horário padrão de um locatário para sites recém-criados. Para obter uma lista de valores possíveis, consulte propriedade SPRegionalSettings.TimeZones. |
Resposta
Se for bem-sucedido, esse método retornará um 200 OK
código de resposta e um objeto de configurações atualizado no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
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
}
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
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)"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de