Règles de priorité des ports
Vous pouvez définir des valeurs de priorité de port basées sur les conditions réseau.
nfa1000
Cette section explique les opérations prises en charge suivantes sur les règles de priorité des ports à l'aide de l'API :
Informations complémentaires :
Utilisation des priorités de portObtenir les règles de priorité des ports
Cette API vous permet d'obtenir la liste des règles de priorité des ports.
URI de la ressource
http://<nfa odata host>:<nfa odata port>/odata/api/portPriorityRules
Méthode
GET
Exemple de demande
http://127.0.0.1:8981/odata/api/portPriorityRules
Exemple de réponse
{ "@odata.context": "http://localhost:8981/odata/api/$metadata#portPriorityRules(ID,portType,startPort,endPort,Description)", "value": [ { "startPort": 1080, "portType": "TCP", "Description": "Socks", "ID": 1, "endPort": 1080 }, { "startPort": 1352, "portType": "TCP", "Description": "Lotus Notes", "ID": 2, "endPort": 1352 }, { "startPort": 1352, "portType": "UDP", "Description": "Lotus Notes", "ID": 3, "endPort": 1352 }, { "startPort": 1433, "portType": "TCP", "Description": "Microsoft SQL Server DBMS Server", "ID": 4, "endPort": 1433 }, { "startPort": 1434, "portType": "UDP", "Description": "Microsoft SQL Server DBMS Monitor", "ID": 5, "endPort": 1434 }, { "startPort": 1494, "portType": "UDP", "Description": "ICA", "ID": 6, "endPort": 1494 }, { "startPort": 1494, "portType": "TCP", "Description": "ICA", "ID": 7, "endPort": 1494 }, { "startPort": 1521, "portType": "TCP", "Description": "Oracle", "ID": 8, "endPort": 1521 }, { "startPort": 2000, "portType": "TCP", "Description": "SCCP (CM Encore)", "ID": 9, "endPort": 2002 }, { "startPort": 2049, "portType": "TCP", "Description": "NFS", "ID": 10, "endPort": 2049 } ], "@odata.nextLink": http://localhost:8981/odata/api/portPriorityRules?timeout=120&$skiptoken=10
Obtenir une règle de priorité de unique
Cette API vous permet d'obtenir une règle de priorité de port unique.
URI de la ressource
http://<nfa odata host>:<nfa odata port>/odata/api/portPriorityRules(portPriorityRuleID)
Méthode
GET
Exemple de demande
http://127.0.0.1:8981/odata/api/portPriorityRules(168)
Exemple de réponse
{ "@odata.context": "$metadata#portPriorityRules", "ID": 168, "portType": "UDP", "startPort": 1080, "endPort": 1080, "Description": "Socks" }
Création de règles de priorité du port
Cette API vous permet de créer une règle de priorité de port.
URI de la ressource
http://<nfa odata host>:<nfa odata port>/odata/api/portPriorityRules
Méthode
POST
Charge utile
{ "startPort": <start port value>, "portType": "<port type value>", "endPort": <end port value>, "Description": "<description details>" }
Exemple de demande
http://127.0.0.1:8981/odata/api/portPriorityRules
Exemple de charge utile
{ "startPort": 1080, "portType": "UDP", "endPort": 1080, "Description": "Socks" }
Exemple de réponse
{ "@odata.context": "$metadata#portPriorityRules", "ID": 168, "portType": "UDP", "startPort": 1080, "endPort": 1080, "Description": "Socks" }
Mise à jour des règles de priorité des ports
Cette API vous permet de mettre à jour une règle de priorité de port unique. Elle ne prend pas en charge les modifications en bloc.
URI de la ressource
http://<nfa odata host>:<nfa odata port>/odata/api/portPriorityRules(portPriorityRuleID)
Méthode
PATCH
Charge utile
{ "startPort": <start port value>, "portType": "<port type value>", "endPort": <end port value>, "Description": "<description details>" }
Exemple de demande
http://127.0.0.1:8981/odata/api/portPriorityRules(168)
Exemple de charge utile
{ "startPort": 1080, "portType": "UDP", "endPort": 1080, "Description": "Socks_Change" }
Exemple de réponse
Cette API ne renvoie aucune réponse.
Suppression des règles de priorité des ports
Cette API vous permet de supprimer une règle de priorité de port unique.
URI de la ressource
http://<nfa odata host>:<nfa odata port>/odata/api/portPriorityRules(portPriorityRuleID)
Méthode
DELETE
Exemple de demande
La demande suivante illustre l'action de suppression pour l'ID de règle de priorité de port 168.
http://127.0.0.1:8981/odata/api/portPriorityRules(168)
Exemple de réponse
Cette API ne renvoie aucune réponse.
Suppression en bloc des règles de priorité des ports
Le code suivant est une section de métadonnées de référence pour supprimer des règles de priorité de port en bloc.
URI de la ressource
http://<nfa odata host>:<nfa odata port>/odata/api/portPriorityRules/com.ca.nfa.deletePortPriorityRules
Méthode
POST
Charge utile
"RuleIds":[<List of rule_ids separated by a comma>]
Exemple de demande
La demande suivante illustre l'action de suppression en bloc des règle de priorité de port.
http://127.0.0.1:8981/odata/api/portPriorityRules/com.ca.nfa.deletePortPriorityRules
Exemple de charge utile
{ "RuleIds": [106,107] }
Exemple de réponse
{ "@odata.context": "$metadata#Collection(com.ca.nfa.odata.portPriorityRules)", "value": [ { "ID": 106, "portType": "TCP", "startPort": 1000, "endPort": 1050, "Description": "Uday3" }, { "ID": 107, "portType": "TCP", "startPort": 1000, "endPort": 1010, "Description": "" } ] }
Contrôles de validation
Les validations de données suivantes doivent être prises en compte lors de la saisie des valeurs.
- La combinaison de PortType, StartPort et EndPort doit être unique.
- Les valeurs de PortType doivent être TCP ou UDP.
- Les valeurs des ports doivent être comprises entre 0 et 65535.
- La longueur de la description doit être inférieure à 120 caractères.