Atualizar configurações

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