Aktualisieren oder Erstellen von trustFrameworkPolicy
Namespace: microsoft.graph
Wichtig: Die APIs der /Beta-Version in Microsoft Graph befinden sich in der Vorschau und können Änderungen unterliegen. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.
Aktualisieren Sie eine vorhandene trustFrameworkPolicy , oder erstellen Sie eine, wenn sie nicht vorhanden ist.
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.ReadWrite.TrustFramework | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Policy.ReadWrite.TrustFramework | Nicht verfügbar. |
Das Geschäfts-, Schul- oder Unikonto muss mindestens über die Microsoft Entra-RolleB2C IEF Keyset-Administrator verfügen.
HTTP-Anforderung
PUT /trustFramework/policies/{id}/$value
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/xml. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext eine XML-Darstellung des trustFrameworkPolicy-Objekts an.
Hinweis: Der Inhaltstyp muss sein
application/xml
.
Antwort
Die Antwort lautet wie folgt:
- Wenn eine trustFrameworkPolicy vorhanden ist, gibt eine erfolgreiche Anforderung einen
200 OK
Antwortcode zurück. - Wenn keine trustFrameworkPolicy vorhanden ist, gibt eine erfolgreiche Anforderung einen
201 Created
Antwortcode zurück. - Wenn die Methode nicht erfolgreich ist, wird ein
4xx
-Fehler mit bestimmten Details zurückgegeben.
Beispiel
Im folgenden Beispiel wird eine trustFrameworkPolicy aktualisiert.
Anforderung
PUT https://graph.microsoft.com/beta/trustFramework/policies/B2C_1A_SocialAndLocalAccounts_Base/$value
Content-Type: application/xml
<TrustFrameworkPolicy xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06" PolicySchemaVersion="0.3.0.0" TenantId="contoso.com" PolicyId="B2C_1A_SocialAndLocalAccounts_Base">
<!---PolicyContent-->
</TrustFrameworkPolicy>
Antwort
HTTP/1.1 200 OK
Content-Type: application/xml
<TrustFrameworkPolicy xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06" PolicySchemaVersion="0.3.0.0" TenantId="contoso.com" PolicyId="B2C_1A_Test" PublicPolicyUri="http://contoso.com/B2C_1A_Test">
.....
....
<!---PolicyContent-->
....
....
</TrustFrameworkPolicy>