Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Atualize uma ou mais configurações de nível de locatário para o SharePoint e o OneDrive.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos 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 com privilégios mais elevados |
|---|---|---|
| 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 à função de Administrador do SharePoint. Para saber mais sobre funções de administrador, consulte Sobre funções de administrador no Centro de administração do Microsoft 365.
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 a serem 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 nas alterações de 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ável para o aplicativo de Sincronização do OneDrive. |
| deletedUserPersonalSiteRetentionPeriodInDays | Int32 | O número de dias para preservar o OneDrive de um usuário excluído. |
| excludedFileExtensionsForSyncApp | String collection | Coleção de extensões de arquivo não carregadas pelo aplicativo de Sincronização do OneDrive. |
| idleSessionSignOut | microsoft.graph.idleSessionSignOut | Especifica as políticas de saída de sessão ociosa 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 modernos 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 de 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 compartilhar novamente arquivos, pastas e sites que não possuem. |
| isSharePointMobileNotificationEnabled | Booliano | Indica se as notificações por push móveis estão habilitadas para o SharePoint. |
| isSharePointNewsfeedEnabled | Booliano | Indica se o news feed é permitido nas páginas de sites modernos 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 a criação de 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 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 computadores ingressados em domínios específicos. |
| personalSiteDefaultStorageLimitInMB | Int64 | O limite de armazenamento padrão do OneDrive para todos os usuários novos e existentes que recebem uma licença qualificada. Medido em megabytes (MB). |
| sharingAllowedDomainList | String collection | Coleção de domínios de email que têm permissão 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 do site de equipe. Este é o caminho no qual os 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 a propriedade SPRegionalSettings.TimeZones. |
Resposta
Se for bem-sucedido, esse método retornará um código de 200 OK 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)"
}