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