Obtener un recurso site

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

Un recurso site se resuelve con un identificador único compuesto de los siguientes valores:

• Nombre de host de la colección de sitios (contoso.sharepoint.com)
• Identificador único (GUID) de la colección de sitios
• Identificador único (GUID) del sitio

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.

Además, se puede acceder al sitio raíz de una instancia geográfica determinada (para inquilinos multigeográficos) con dataLocationCode de la geografía, como se indica a continuación:

• /sites/NAM: sitio raíz de la instancia de Norteamérica del inquilino
• /sites/EUR: sitio raíz de la instancia europea del inquilino

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

Obtener el sitio raíz del inquilino

Para obtener acceso al sitio de SharePoint de raíz dentro de un inquilino:

GET /sites/root
GET /sites/contoso.sharepoint.com
GET /sites/JPN

Obtener acceso a un sitio mediante la dirección URL relativa al servidor

Si tiene la dirección URL relativa al servidor de un recurso site, puede construir una solicitud de la manera siguiente:

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

Obtener acceso a un sitio de grupo

Para obtener acceso al sitio de grupo de un grupo:

GET /groups/{group-id}/sites/root

Ejemplo

Solicitud

GET /sites/{site-id}

Respuesta

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