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.

Criar um novo site do SharePoint.

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ão com privilégios mínimos Permissões com privilégios mais elevados
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 da solicitação, forneça uma representação JSON do objeto do site .

Você pode especificar as propriedades a seguir 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 configuraçõ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 somente no momento da criação do site. Opcional.
shareByEmailEnabled Booliano Determina se o site e seu conteúdo podem ser compartilhados por email. Opcional.
template siteTemplateType Especifica o modelo aplicado ao site. Os valores possíveis são: sitepagepublishing, sts, unknownFutureValue. Opcional.
webUrl String A URL do site que só pode ser fornecida no momento da criação do site. Herdado de baseItem. Opcional.

Resposta

Se for bem-sucedido, esse método retornará um código de 202 Accepted resposta e um objeto de site no corpo da resposta. A resposta também contém um Location cabeçalho, que contém o local do getOperationStatus que foi criado para lidar com a operação de criação do site. Verifique o status da operação de criação fazendo uma solicitação GET para esse local.

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=')