Répertorier les sites
Espace de noms: microsoft.graph
Répertorier tous les sites disponibles dans un organization.
Des critères de filtre et des options de requête spécifiques sont également pris en charge et décrits ci-dessous :
Filter, instruction | Instruction Select | Description |
---|---|---|
siteCollection/root ne null |
siteCollection,webUrl |
Listes toutes les collections de sites de niveau racine dans le organization. Utile pour découvrir le site d’accueil pour chaque zone géographique. |
En outre, vous pouvez utiliser une requête $search sur la /sites
collection pour rechercher des sites correspondant à des mots clés donnés.
Si vous souhaitez répertorier tous les sites dans toutes les zones géographiques, reportez-vous à getAllSites.
Pour plus d’informations sur la création d’applications qui utilisent la découverte de site à des fins d’analyse, consultez Meilleures pratiques pour la découverte de fichiers et la détection des modifications à grande échelle.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
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.
Répertorier toutes les collections de sites
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) | Non prise en charge. |
Déléguée (compte Microsoft personnel) | Non prise en charge. |
Application | Sites.Read.All, Sites.ReadWrite.All |
Découvrir le site d’accueil de chaque zone géographique
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
Pour répertorier tous les sites disponibles dans un organization :
GET /sites
Pour répertorier toutes les collections de sites de niveau racine dans un organization :
GET /sites?$filter=siteCollection/root ne null
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Exemples
Exemple 1 : Répertorier les sites à l’aide de paramètres de requête
Demande
GET https://graph.microsoft.com/v1.0/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"
}
]
}
Exemple 2 : Répertorier tous les sites
Demande
GET https://graph.microsoft.com/v1.0/sites
Réponse
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id": "contoso.sharepoint.com,bf6fb551-d508-4946-a439-b2a6154fc1d9,65a04b8b-1f44-442b-a1fc-9e5852fb946c",
"name": "Root Site",
"isPersonalSite": false,
"root": { },
"siteCollection": {
"hostname": "contoso.sharepoint.com",
"dataLocationCode": "NAM",
"root": { }
},
"webUrl": "https://contoso.sharepoint.com"
},
{
"id": "contoso.sharepoint.com,d9ecf079-9b13-4376-ac5d-f242dda55626,746dbcc1-fa2b-4120-b657-2670bae5bb6f",
"name": "Site A",
"isPersonalSite": false,
"root": { },
"siteCollection": {
"hostname": "contoso.sharepoint.com"
},
"webUrl": "https://contoso.sharepoint.com/sites/siteA"
},
{
"id": "contoso.sharepoint.com,fd1a778f-263e-4c43-acdf-d5c2519d80eb,c06016db-dfec-4f79-83a1-09c6dbfd7022",
"name": "Site B",
"isPersonalSite": false,
"root": { },
"siteCollection": {
"hostname": "contoso.sharepoint.com"
},
"webUrl": "https://contoso.sharepoint.com/sites/siteB"
}
]
}