Obtener un recurso de sitio mediante la ruta de acceso
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"
}