Créer une règle

Crée une nouvelle règle d'autorisation au sein d'une organisation.

Endpoint

POST /api/Rule

Corps de la requête

Champ	Saisie de texte	Requis	Description
name	Chaîne de caractères (string)	Oui (Yes)	Nom de la règle
description	Chaîne de caractères (string)	Non (No)	Description de l'objectif de la règle
enabled	Booléen	Oui (Yes)	Indique si la règle est active
definition	Chaîne de caractères (string)	Non (No)	La définition de règle, exprimée sous la forme d’une chaîne encodée en JSON.
partitionGlobalId	GUID	Oui (Yes)	L’identifiant global de l’organisation. Pour obtenir des étapes sur la récupération partitionGlobalId, consultez la section Récupération de l’ID partitionGlobalId pour utiliser l’API.

En-têtes de requête.

--header 'Authorization: Bearer {access_token}'
--header 'Content-Type: application/json'

Réponses

Remarque :

1. La réponse renvoie la règle créée en tant que RuleDto, y compris la id générée.
2. partitionGlobalId peut être renvoyé comme le GUID zéro en fonction de l'environnement ou du comportement du fournisseur de règles.
3. definition est conservé et renvoyé sous la forme d’une chaîne encodée en JSON.
4. assignedGroups est renvoyé sous la forme d'un tableau vide ([]) lorsqu'aucun groupe n'est résolu au moment de la création.

{
  "id": 3684,
  "partitionGlobalId": "00000000-0000-0000-0000-000000000000",
  "name": "Test",
  "description": "Test",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"4d161738-7204-4794-b839-8f7fed28366c\"],\"Conditions\":[]}",
  "assignedGroups": []
}

Exemple de requête

{
  "name": "Test",
  "description": "Test",
  "partitionGlobalId": "47a714db-cd27-4250-9668-2054e008c448",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"4d161738-7204-4794-b839-8f7fed28366c\"],\"Conditions\":[]}"
}

Réponses d’erreur

• 400 Bad Request: Corps de requête non valide ou erreurs de validation
• 401 Unauthorized: jeton d’authentification manquant ou non valide
• 403 Forbidden: Autorisations insuffisantes
• 404 Not Found: l’organisation n’existe pas