Obtener un recurso de sitio mediante la ruta de acceso

  • Artículo

Espacio de nombres: microsoft.graph

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

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

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Ejemplo

Solicitud

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

GET https://graph.microsoft.com/v1.0/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
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"
}