Compartilhar via


Atualizar configurações

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Atualize uma ou mais definições ao nível do inquilino para o SharePoint e o OneDrive.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
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 utilizador, o utilizador tem de pertencer à função de Administrador do SharePoint. Para saber mais sobre as funções de administrador, consulte Acerca das 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 do pedido, forneça apenas os valores das propriedades a atualizar. As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a 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 fidedigno para a aplicação Sincronização do OneDrive.
deletedUserPersonalSiteRetentionPeriodInDays Int32 O número de dias para preservar o OneDrive de um utilizador eliminado.
excludedFileExtensionsForSyncApp Coleção de cadeias de caracteres Coleção de extensões de ficheiro não carregadas pela aplicação Sincronização do OneDrive.
idleSessionSignOut microsoft.graph.idleSessionSignOut Especifica as políticas de início de sessão inativo para o inquilino.
imageTaggingOption imageTaggingChoice Especifica a opção de identificação de imagens para o inquilino. 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 push estão ativadas para eventos do OneDrive.
isLegacyAuthProtocolsEnabled Booliano Indica se os protocolos de autenticação legados estão ativados para o inquilino.
isLoopEnabled Booliano Indica se o Fluid Framework é permitido em sites do SharePoint.
isMacSyncAppEnabled Booliano Indica se os ficheiros podem ser sincronizados com a aplicação Sincronização do OneDrive para Mac.
isRequireAcceptingUserToMatchInvitedUserEnabled Booliano Indica se os convidados têm de iniciar sessão com a mesma conta para a qual os convites de partilha são enviados.
isResharingByExternalUsersEnabled Booliano Indica se os convidados têm permissão para voltar a partilhar ficheiros, pastas e sites que não possuem.
isSharePointMobileNotificationEnabled Booliano Indica se as notificações push para dispositivos móveis estão ativadas para o SharePoint.
isSharePointNewsfeedEnabled Booliano Indica se o newsfeed é permitido nas páginas modernas do site no SharePoint.
isSiteCreationEnabled Booliano Indica se os utilizadores têm permissão para criar sites.
isSiteCreationUIEnabled Booliano Indica se os comandos de IU para criar sites são apresentados.
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 é gerido automaticamente ou se são definidos limites de armazenamento específicos por site.
isSyncButtonHiddenOnPersonalSite Booliano Indica se o botão de sincronização no OneDrive está oculto.
isUnmanagedSyncAppForTenantRestricted Booliano Indica se os utilizadores têm permissão para sincronizar ficheiros apenas em PCs associados a domínios específicos.
personalSiteDefaultStorageLimitInMB Int64 O limite de armazenamento predefinido do OneDrive para todos os utilizadores novos e existentes a quem foi atribuída uma licença elegível. Medido em megabytes (MB).
sharingAllowedDomainList Coleção String Coleção de domínios de e-mail permitidos para partilha fora da organização.
sharingBlockedDomainList Coleção de cadeias de caracteres Coleção de domínios de e-mail que estão bloqueados para partilha fora da organização.
sharingCapability sharingCapabilities Capacidade de partilha para o inquilino. 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 gerido do site de equipa. Este é o caminho no qual serão criados novos sites de equipa.
siteCreationDefaultStorageLimitInMB Int32 A quota de armazenamento predefinida para um novo site após a criação. Medido em megabytes (MB).
tenantDefaultTimezone Cadeia de caracteres O fuso horário predefinido de um inquilino para sites criados recentemente. Para obter uma lista de valores possíveis, veja a propriedade SPRegionalSettings.TimeZones.

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto de definições atualizado no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

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
}

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