Compartir a través de

Obtener un recurso de sitio mediante la ruta de acceso

  • Artículo

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta 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 la versión 1.0, use el selector de Versión.

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

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Sites.Read.All Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. 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 https://graph.microsoft.com/beta/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"
}