Ermitteln einer Multi-Geo-Mandantenkonfiguration
Wenn Sie mit einem SharePoint-Mandanten arbeiten, müssen Sie in der Lage sein, zu ermitteln, ob es sich um einen Multi-Geo-Mandanten handelt, und die standardmäßigen geografischen Standorte sowie die Satellitenstandorte zu identifizieren.
In der folgenden Abbildung ist ein Multi-Geo-Mandant mit Folgendem dargestellt:
- Einem standardmäßigen geografischen Speicherort in Nordamerika.
- Einem Satellitenstandort in Europa.
- Einem Satellitenstandort in Asien.
Abrufen von Informationen zu einer Multi-Geo-Mandantenkonfiguration
In Abhängigkeit von Ihrem Szenario können Sie eine der folgenden APIs oder eine Kombination verwenden, um auf eine Multi-Geo-Mandantenwebsite zuzugreifen:
CSOM-API für SharePoint: Nicht Multi-Geo-fähig. Je nach Szenario müssen Sie auf den korrekten geografischen Standort abzielen (um zum Beispiel auf ein Benutzerprofil zuzugreifen oder Mandanten-API-Vorgänge auszuführen).
Die Microsoft Graph-API: Multi-Geo-fähig. Es wird empfohlen, dass Sie Microsoft Graph verwenden um auf Multi-Geo-Mandantenwebsites zuzugreifen.
REST-API für SharePoint: Diese API wird in der Regel im Kontext einer Website-URL verwendet, deshalb ist es nicht relevant, ob der Mandant Multi-Geo-fähig ist. Einige REST-API-Szenarien (z. B. Such- oder Benutzerprofile) erfordern möglicherweise Aufrufe pro geografischem Standort.
Verwenden der CSOM-API
Das Abrufen des geografischen Standorts Ihres Mandanten kann über CSOM mithilfe der Tenant-Klasse und der GetTenantInstances-Methode erfolgen, wie im folgenden Codeausschnitt dargestellt:
Tenant tenant = new Tenant(clientContext);
var tenantInstances = tenant.GetTenantInstances();
clientContext.Load(tenantInstances);
clientContext.ExecuteQuery();
Verwenden der Microsoft Graph-API
Sie können die geografischen Standortinformationen für einen Mandanten mithilfe von Microsoft Graph abrufen. Das folgende Beispiel gibt eine Sammlung mit einem Objekt pro geografischem Standort zurück.
Hinweis
Im folgenden Codebeispiel wird das dataLocationCode-Attribut für das siteCollection-Objekt verwendet. Zum Zeitpunkt der Veröffentlichung ist diese Eigenschaft nur am Microsoft Graph Beta-Endpunkt verfügbar.
GET https://graph.microsoft.com/beta/sites?filter=siteCollection/root%20ne%20null&select=webUrl,siteCollection
Beispielantwort für einen Multi-Geo-Mandanten
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#sites",
"value": [
{
"webUrl": "https://contoso.sharepoint.com/",
"siteCollection": {
"dataLocationCode":"NAM",
"hostname": "contoso.sharepoint.com"
}
},
{
"webUrl": "https://contosoeur.sharepoint.com/",
"siteCollection": {
"dataLocationCode":"EUR",
"hostname": "contosoeur.sharepoint.com"
}
},
{
"webUrl": "https://contosoapc.sharepoint.com/",
"siteCollection": {
"dataLocationCode":"APC",
"hostname": "contosoapc.sharepoint.com"
}
}
]
}
Weitere Informationen finden Sie im Beispiel MultiGeo.TenantInformationCollection.
Hinweis
Weitere Informationen zu Berechtigungen und zum Konfigurieren Ihrer Anwendung finden Sie unter Einrichten einer Multi-Geo-Beispielanwendung.
Ermitteln, ob Ihr Mandant Multi-Geo-fähig ist
Sie können Microsoft Graph verwenden, um zu ermitteln, ob Ihr Mandant Multi-Geo-fähig ist, da Anfragen an Multi-Geo-Mandanten über Microsoft Graph mehrere Elemente in der Sammlung zurückgeben.
Das folgende Beispiel zeigt die Ergebnisse eines Microsoft Graph-Aufrufs eines einzelnen Single-Geo-Mandanten.
GET https://graph.microsoft.com/beta/sites?filter=siteCollection/root%20ne%20null&select=webUrl,siteCollection
Beispielantwort für einen Single-Geo-Mandanten
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#sites",
"value": [
{
"webUrl": "https://singlegeotest.sharepoint.com/",
"siteCollection": {
"dataLocationCode":"",
"hostname": "singlegeotest.sharepoint.com"
}
}
]
}