Partner auflisten
Namespace: microsoft.graph
Ruft eine Liste aller Partnerkonfigurationen innerhalb einer mandantenübergreifenden Zugriffsrichtlinie ab. Sie können den $expand
Parameter auch verwenden, um die Benutzersynchronisierungsrichtlinie für alle Partnerkonfigurationen aufzulisten.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Policy.Read.All | Policy.ReadWrite.CrossTenantAccess |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Policy.Read.All | Policy.ReadWrite.CrossTenantAccess |
HTTP-Anforderung
GET /policies/crossTenantAccessPolicy/partners
Optionale Abfrageparameter
Diese Methode unterstützt die $select
OData-Abfrageparameter und $expand
zum Anpassen der Antwort. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich verläuft, werden der 200 OK
Antwortcode und eine Auflistung von crossTenantAccessPolicyConfigurationPartner-Objekten im Antworttext zurückgegeben.
Beispiele
Beispiel 1: Auflisten aller Partnerkonfigurationen innerhalb einer mandantenübergreifenden Zugriffsrichtlinie
Das folgende Beispiel zeigt, wie Sie alle Partnerkonfigurationen innerhalb einer mandantenübergreifenden Zugriffsrichtlinie auflisten.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/partners
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"tenantId": "123f4846-ba00-4fd7-ba43-dac1f8f63013",
"inboundTrust": null,
"isInMultiTenantOrganization": false,
"automaticUserConsentSettings": {
"inboundAllowed": null,
"outboundAllowed": null
},
"b2bCollaborationInbound": null,
"b2bCollaborationOutbound": null,
"b2bDirectConnectOutbound": null,
"b2bDirectConnectInbound": {
"usersAndGroups": {
"accessType": "allowed",
"targets": [
{
"target": "AllUsers",
"targetType": "user"
}
]
},
"applications": {
"accessType": "allowed",
"targets": [
{
"target": "Office365",
"targetType": "application"
}
]
}
}
}
]
}
Beispiel 2: Auflisten der Benutzersynchronisierungsrichtlinie für alle Partnerkonfigurationen
Im folgenden Beispiel wird der $expand
-Parameter verwendet, um die Benutzersynchronisierungsrichtlinie für alle Partnerkonfigurationen aufzulisten.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/partners?$select=tenantId&$expand=identitySynchronization
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"tenantId": "9c5d131d-b1c3-4fc4-9e3f-c6557947d551",
"identitySynchronization": {
"tenantId": "9c5d131d-b1c3-4fc4-9e3f-c6557947d551",
"displayName": "Fabrikam",
"userSyncInbound": {
"isSyncAllowed": true
}
}
}
]
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für