Partager via


Mettre à jour webApplicationFirewallProvider

Espace de noms: microsoft.graph

Mettez à jour les propriétés d’un objet webApplicationFirewallProvider .

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

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) RiskPreventionProviders.ReadWrite.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application RiskPreventionProviders.ReadWrite.All Non disponible.

Importante

Dans les scénarios délégués avec des comptes professionnels ou scolaires, l’administrateur doit se voir attribuer un rôle Microsoft Entra pris en charge ou un rôle personnalisé avec une autorisation de rôle prise en charge. Les rôles les moins privilégiés suivants sont pris en charge pour cette opération :

  • administrateur de flux utilisateur ID externe
  • Administrateur de l'application
  • Administrateur de sécurité

Requête HTTP

PATCH /identity/riskPrevention/webApplicationFirewallProviders/{webApplicationFirewallProviderId}

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez uniquement les valeurs des propriétés à mettre à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété.

Le tableau suivant spécifie les propriétés qui peuvent être mises à jour.

Vous devez spécifier la propriété @odata.type pour spécifier le type d’objet webApplicationFirewallProvider à mettre à jour. Par exemple, « @odata.type » : « #microsoft.graph.akamaiWebApplicationFirewallProvider ».

Propriété Type Description
displayName String Nom complet convivial de la configuration du fournisseur Web Application Firewall.
accessToken String Jeton d’accès de l’API Akamai utilisé pour l’authentification auprès du compte Akamai. Contactez votre Customer Success Manager Akamai pour obtenir de l’aide sur votre accessToken. Pris en charge pour Akamai uniquement.
clientSecret String Clé secrète client de l’API Akamai utilisée conjointement avec le jeton client et le jeton d’accès pour l’authentification. Contactez votre Customer Success Manager Akamai pour obtenir de l’aide sur ces informations. Pris en charge pour Akamai uniquement.
clientToken String Jeton client de l’API Akamai utilisé pour l’authentification auprès du compte Akamai. Contactez votre Customer Success Manager Akamai pour obtenir de l’aide sur ces informations. Pris en charge pour Akamai uniquement.
hostPrefix String Préfixe utilisé pour identifier l’hôte ou le domaine dans les opérations de configuration Akamai. Cette valeur peut être requise pour certains appels d’API ou scénarios de configuration. Pris en charge pour Akamai uniquement.
apiToken String Jeton ou informations d’identification de l’API Cloudflare utilisés par les services Microsoft pour s’authentifier auprès du compte Cloudflare. Pour obtenir de l’aide sur votre apitoken, contactez votre responsable de réussite client Cloudflare. Pris en charge pour Cloudflare uniquement.
zoneId String ID de zone Cloudflare par défaut associé à cette configuration de fournisseur. Cet ID identifie la zone DNS dans Cloudflare qui est couramment utilisée pour les opérations de vérification et de configuration du fournisseur. Pris en charge pour Cloudflare uniquement.

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet webApplicationFirewallProvider mis à jour dans le corps de la réponse.

Exemples

Demande

L’exemple suivant illustre une demande.

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

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

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-Type: application/json

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