Obtener un recurso de sitio mediante la ruta de acceso

Espacio de nombres: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en v1.0, use el selector de versiones.

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 siguientes permisos 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

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

HTTP/1.1 200 OK

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "owner": {
    "user": { 
      "displayName": "Daron Spektor",
      "id": "5280E7FE-DC7A-4486-9490-E790D81DFEB3"
    }
  },
  "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"
}