Freigeben über


Aktualisieren von webApplicationFirewallProvider

Namespace: microsoft.graph

Aktualisieren sie die Eigenschaften eines webApplicationFirewallProvider-Objekts .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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) RiskPreventionProviders.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application RiskPreventionProviders.ReadWrite.All Nicht verfügbar.

Wichtig

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem Administrator eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit einer unterstützten Rollenberechtigung zugewiesen werden. Für diesen Vorgang werden die folgenden Rollen mit den geringsten Berechtigungen unterstützt:

  • External ID Benutzerflowadministrator
  • Anwendungsadministrator
  • Sicherheitsadministrator

HTTP-Anforderung

PATCH /identity/riskPrevention/webApplicationFirewallProviders/{webApplicationFirewallProviderId}

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext nur die Werte für zu aktualisierende Eigenschaften an. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.

In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.

Sie müssen die @odata.type-Eigenschaft angeben, um den Typ des zu aktualisierenden webApplicationFirewallProvider-Objekts anzugeben. Beispiel: "@odata.type": "#microsoft.graph.akamaiWebApplicationFirewallProvider".

Eigenschaft Typ Beschreibung
displayName Zeichenfolge Der Anzeigename der Web Application Firewall Anbieterkonfiguration.
accessToken Zeichenfolge Akamai-API-Zugriffstoken, das für die Authentifizierung beim Akamai-Konto verwendet wird. Wenden Sie sich an Ihren Akamai Customer Success Manager, um Unterstützung bei Ihrem accessToken zu erhalten. Wird nur für Akamai unterstützt.
clientSecret Zeichenfolge Der geheime Akamai-API-Clientschlüssel wird in Verbindung mit dem Clienttoken und dem Zugriffstoken für die Authentifizierung verwendet. Wenden Sie sich an Ihren Akamai Customer Success Manager, um Unterstützung bei diesen Informationen zu erhalten. Wird nur für Akamai unterstützt.
clientToken Zeichenfolge Akamai-API-Clienttoken, das für die Authentifizierung beim Akamai-Konto verwendet wird. Wenden Sie sich an Ihren Akamai Customer Success Manager, um Unterstützung bei diesen Informationen zu erhalten. Wird nur für Akamai unterstützt.
hostPrefix Zeichenfolge Präfix, das zum Identifizieren des Hosts oder der Domäne in Akamai-Konfigurationsvorgängen verwendet wird. Dieser Wert kann für bestimmte API-Aufrufe oder Konfigurationsszenarien erforderlich sein. Wird nur für Akamai unterstützt.
apiToken Zeichenfolge Cloudflare-API-Token oder Anmeldeinformationen, die von Microsoft-Diensten zur Authentifizierung beim Cloudflare-Konto verwendet werden. Wenden Sie sich an Ihren Cloudflare Customer Success Manager, um Unterstützung bei Ihrem apitoken zu erhalten. Wird nur für Cloudflare unterstützt.
zoneId Zeichenfolge Dieser Anbieterkonfiguration zugeordnete Standard-Cloudflare-Zonen-ID. Diese ID identifiziert die DNS-Zone in Cloudflare, die häufig für Überprüfungs- und Konfigurationsvorgänge für den Anbieter verwendet wird. Wird nur für Cloudflare unterstützt.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und ein aktualisiertes webApplicationFirewallProvider-Objekt im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/v1.0/identity/riskPrevention/webApplicationFirewallProviders/{webApplicationFirewallProviderId}
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.cloudFlareWebApplicationFirewallProvider",
  "displayName": "String"
}

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

{
  "@odata.type": "#microsoft.graph.cloudFlareWebApplicationFirewallProvider",
  "id": "4d8ac75a-e882-18c6-8ad4-2ab20c742e52",
  "displayName": "String"
}