Compartilhar via

Obter um recurso de site pelo caminho

  • Artigo

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

Uma das permissões a seguir é necessária para chamar essa API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) Sites.Read.All, Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo Sites.Read.All, Sites.ReadWrite.All

Solicitação HTTP

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

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

Resposta HTTP

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",
  "name": "1drvteam",
  "createdDateTime": "2017-05-09T20:56:00Z",
  "lastModifiedDateTime": "2017-05-09T20:56:01Z",
  "webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}