Enumerar sitios

Enumere los sitios disponibles en una organización que coincidan con los criterios de filtro proporcionados y las opciones de consulta.

Actualmente solo se admiten las siguientes opciones de consulta:

Instrucción Filter	Select (instrucción)	Descripción
siteCollection/root ne null	siteCollection,webUrl	Enumera todas las colecciones de sitios de nivel raíz de la organización. Útil para descubrir el sitio principal de cada geografía.

Además, puede usar una consulta de búsqueda en la colección "/sites" para buscar sitios que coincidan con palabras clave dadas.

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

Solicitud HTTP

GET /sites?filter=siteCollection/root ne null

Ejemplo

Solicitud

GET /sites?select=siteCollection,webUrl&filter=siteCollection/root%20ne%20null

Respuesta

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "id": "contoso.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740",
      "name": "Contoso USA",
      "root": { },
      "siteCollection": {
        "hostname": "contoso.sharepoint.com",
        "dataLocationCode": "NAM",
        "root": { }
      },
      "webUrl": "https://contoso.sharepoint.com"
    },
    {
      "id": "contoso-jpn.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,0271110f-634f-4300-a841-3a8a2e851851",
      "name": "Contoso Japan",
      "root": { },
      "siteCollection": {
        "hostname": "contoso-jp.sharepoint.com",
        "dataLocationCode": "JPN",
        "root": { }
      },
      "webUrl": "https://contoso-jp.sharepoint.com"
    }
  ]
}