Énumérer des sites

Article
04/08/2023

Répertorier les sites disponibles dans une organisation qui correspondent aux critères de filtre et aux options de requête fournis.

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

Filter, instruction	Instruction Select	Description
`siteCollection/root ne null`	`siteCollection,webUrl`	Répertorie toutes les collections de sites au 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 requise 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 plus de privilèges à celle qui en offre le moins)
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"
    }
  ]
}

Partager via