Partilhar via


Criar site

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.

Crie um novo site do SharePoint.

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ão com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) Sites.Create.All Sites.FullControl.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application Sites.Create.All Sites.FullControl.All

Solicitação HTTP

POST /sites

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 uma representação JSON do objeto do site .

Pode especificar as seguintes propriedades ao criar um site.

Propriedade Tipo Descrição
description Cadeia de caracteres O texto descritivo do site. Herdado de baseItem.
localidade Cadeia de caracteres As definições de idioma do site.
nome Cadeia de caracteres O nome do site. Herdado de baseItem. Opcional.
ownerIdentityToResolve identityInput O proprietário do site a ser fornecido apenas no momento da criação do site. Opcional.
shareByEmailEnabled Booliano Determina se o site e o respetivo conteúdo podem ser partilhados por e-mail. Opcional.
template siteTemplateType Especifica o modelo aplicado ao site. Os valores possíveis são: sitepagepublishing, group, sts, unknownFutureValue. Opcional.
webUrl String O URL do site que só pode ser fornecido no momento da criação do site. Herdado de baseItem. Opcional.

Resposta

Se for bem-sucedido, este método devolve um 202 Accepted código de resposta e um objeto de site no corpo da resposta. A resposta também contém um Location cabeçalho, que contém a localização do getOperationStatus que foi criado para processar a operação de criação do site. Verifique a status da operação de criação ao fazer um pedido GET para esta localização.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/sites
Content-Type: application/json

{
  "name": "Communication Site Test",
  "webUrl": "https://contoso.sharepoint.com/sites/commsite1",
  "locale": "en-US",
  "shareByEmailEnabled": false,
  "description": "Test Site Description",
  "template": "sitepagepublishing",
  "ownerIdentityToResolve": {
    "email": "ryan@contoso.com"
  }
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/sites/getOperationStatus(operationId='JXMnaHR0cHMlM0ElMkYlMkZncmFwaC5taWNyb3NvZnQuY29tJTJGc2l0ZXMlMkZ0ZWFtc2l0ZTE=')