Éumer les sites

List the available sites in an organization that match provided filter criteria and query options.

Seules les options de requête suivantes sont actuellement pris en charge :

Instruction Filter	Select, instruction	Description
siteCollection/root ne null	siteCollection,webUrl	Répertorie toutes les collections de sites de niveau racine de l’organisation. Utile pour découvrir le site d’accueil pour chaque zone géographique.

En outre, vous pouvez utiliser une [requête][] de recherche sur la collection « /sites » pour rechercher des sites correspondant à des mots clés donnés.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le moins de privilèges à celle qui en offre le plus)
Déléguée (compte professionnel ou scolaire)	Sites.Read.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	Sites.Read.All, Sites.ReadWrite.All

Requête HTTP

GET /sites?filter=siteCollection/root ne null

Exemple

Demande

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

Réponse

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