Compartir a través de

Obtener un recurso de sitio mediante la ruta de acceso

  • Artículo

Recupera las propiedades y relaciones de un recurso site. Un recurso site representa un sitio de grupo de SharePoint.

Además de recuperar un sitio mediante id., puede recuperar un sitio basándose en la ruta de URL relativa del servidor.

  • Nombre de host de la colección de sitios (contoso.sharepoint.com)
  • Ruta de sitio, relativa al nombre de host del servidor.

También hay un identificador de sitio reservado, root, que siempre hace referencia al sitio raíz para un destino especificado de la manera siguiente:

  • /sites/root: El sitio raíz del inquilino.
  • /groups/{group-id}/sites/root: Sitio del grupo.

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) Sites.Read.All, Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación Sites.Read.All, Sites.ReadWrite.All

Solicitud HTTP

Para obtener acceso al sitio de SharePoint de raíz con una ruta relativa:

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

Respuesta HTTP

Este método devuelve un recurso site para el sitio al que se hace referencia mediante el identificador único.

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