Compartilhar via


Obter um recurso de site pelo caminho

Namespace: microsoft.graph

Recupere as propriedades e as relações de um recurso de site. Um recurso site representa um site de equipe no SharePoint.

Além de recuperar um site pelo ID, você pode recuperar um site com base no caminho da URL relativa ao servidor.

  • Hostname do conjunto de sites (contoso.sharepoint.com)
  • Caminho do site, em relação ao nome de host do servidor.

Há também um identificador de site reservado, root, que sempre faz referência ao site raiz de um determinado destino da seguinte maneira:

  • /sites/root: O site raiz do locatário.
  • /groups/{group-id}/sites/root: O site da equipe do grupo.

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas
Delegado (conta corporativa ou de estudante) Sites.Read.All Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sites.Read.All Sites.ReadWrite.All

Solicitação HTTP

GET /sites/{hostname}:/{relative-path}

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Exemplo

Solicitação

Para acessar o site raiz do SharePoint com um caminho relativo:

GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{relative-path}

Resposta

Este método retorna um recurso de site para o site referenciado pelo identificador exclusivo.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "displayName": "OneDrive Team Site",
  "isPersonalSite": false,
  "name": "1drvteam",
  "createdDateTime": "2017-05-09T20:56:00Z",
  "lastModifiedDateTime": "2017-05-09T20:56:01Z",
  "webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}