From: x-fn-spp-ml@ntt-tx.co.jp
To: spp@dpdk.org, ferruh.yigit@intel.com, yasufum.o@gmail.com
Subject: [spp] [PATCH v2 04/11] docs: add description of REST-APIs for flow rules
Date: Fri, 27 Mar 2020 13:57:25 +0900 [thread overview]
Message-ID: <20200327045732.18463-5-x-fn-spp-ml@ntt-tx.co.jp> (raw)
In-Reply-To: <20200226113521.3787-1-x-fn-spp-ml@ntt-tx.co.jp>
From: Hideyuki Yamashita <yamashita.hideyuki@ntt-tx.co.jp>
This patch adds REST-API description for flow rules.
Signed-off-by: Hideyuki Yamashita <yamashita.hideyuki@ntt-tx.co.jp>
Signed-off-by: Naoki Takada <ntakada14@gmail.com>
---
docs/guides/api_ref/spp_primary.rst | 208 ++++++++++++++++++++++++++++
1 file changed, 208 insertions(+)
diff --git a/docs/guides/api_ref/spp_primary.rst b/docs/guides/api_ref/spp_primary.rst
index 382915f..fbf8874 100644
--- a/docs/guides/api_ref/spp_primary.rst
+++ b/docs/guides/api_ref/spp_primary.rst
@@ -438,3 +438,211 @@ Equivalent CLI command
.. code-block:: none
pri; launch {proc_type} {sec_id} {eal_opts} -- {app_opts}
+
+POST /v1/primary/flow_rules/port_id/{port_id}/validate
+------------------------------------------------------
+
+Validate flow rule for specific port_id.
+
+* Normal response codes: 200
+
+
+Request example
+~~~~~~~~~~~~~~~
+
+.. code-block:: console
+
+ $ curl -X POST \
+ http://127.0.0.1:7777/v1/primary/flow_rules/port_id/0/validate \
+ -H "Content-type: application/json" \
+ -d '{ \
+ "rule": \
+ { \
+ "group": 0, \
+ "priority": 0, \
+ "direction": "ingress", \
+ "transfer": true, \
+ "pattern": \
+ [ \
+ "eth dst is 11:22:33:44:55:66 type mask 0xffff", \
+ "vlan vid is 100" \
+ ], \
+ "actions": \
+ [ \
+ "queue index 1", \
+ "of_pop_vlan" \
+ ] \
+ } \
+ }'
+
+Response
+~~~~~~~~
+
+.. _table_spp_ctl_primary_flow_validate:
+
+.. table:: Response params of validate.
+
+ +------------+--------+----------------------------------------+
+ | Name | Type | Description |
+ | | | |
+ +============+========+========================================+
+ | result | string | Validation result. |
+ +------------+-------++----------------------------------------+
+ | message | string | Additional information if any. |
+ +------------+-------++----------------------------------------+
+
+Response example
+~~~~~~~~~~~~~~~~
+
+.. code-block:: json
+
+ {
+ "result" : "success",
+ "message" : "Flow rule validated"
+ }
+
+POST /v1/primary/flow_rules/port_id/{port_id}
+---------------------------------------------
+
+Create flow rule for specific port_id.
+
+* Normal response codes: 200
+
+
+Request example
+~~~~~~~~~~~~~~~
+
+.. code-block:: console
+
+ $ curl -X POST http://127.0.0.1:7777/v1/primary/flow_rules/port_id/0 \
+ -H "Content-type: application/json" \
+ -d '{ \
+ "rule": \
+ { \
+ "group": 0, \
+ "priority": 0, \
+ "direction": "ingress", \
+ "transfer": true, \
+ "pattern": \
+ [ \
+ "eth dst is 11:22:33:44:55:66 type mask 0xffff", \
+ "vlan vid is 100" \
+ ], \
+ "actions": \
+ [ \
+ "queue index 1", \
+ "of_pop_vlan" \
+ ] \
+ } \
+ }'
+
+Response
+~~~~~~~~
+
+.. _table_spp_ctl_primary_flow_create:
+
+.. table:: Response params of flow creation.
+
+ +------------+--------+----------------------------------------+
+ | Name | Type | Description |
+ | | | |
+ +============+========+========================================+
+ | result | string | Creation result. |
+ +------------+--------+----------------------------------------+
+ | message | string | Additional information if any. |
+ +------------+--------+----------------------------------------+
+ | rule_id | string | Rule id allocated if successful. |
+ +------------+--------+----------------------------------------+
+
+Response example
+~~~~~~~~~~~~~~~~
+
+.. code-block:: json
+
+ {
+ "result" : "success",
+ "message" : "Flow rule #0 created",
+ "rule_id" : "0"
+ }
+
+DELETE /v1/primary/flow_rule/port_id/{port_id}
+----------------------------------------------
+
+Delete all flow rule for specific port_id.
+
+* Normal response codes: 200
+
+
+Request example
+~~~~~~~~~~~~~~~
+
+.. code-block:: console
+
+ $ curl -X DELETE http://127.0.0.1:7777/v1/primary/flow_rule/port_id/0
+
+Response
+~~~~~~~~
+
+.. _table_spp_ctl_primary_flow_flush:
+
+.. table:: Response params of flow flush.
+
+ +------------+--------+----------------------------------------+
+ | Name | Type | Description |
+ | | | |
+ +============+========+========================================+
+ | result | string | Deletion result. |
+ +------------+--------+----------------------------------------+
+ | message | string | Additional information if any. |
+ +------------+--------+----------------------------------------+
+
+Response example
+~~~~~~~~~~~~~~~~
+
+.. code-block:: json
+
+ {
+ "result" : "success",
+ "message" : "Flow rule all destroyed"
+ }
+
+DELETE /v1/primary/flow_rule/{rule_id}/port_id/{port_id}
+--------------------------------------------------------
+
+Delete specific flow rule for specific port_id.
+
+* Normal response codes: 200
+
+
+Request example
+~~~~~~~~~~~~~~~
+
+.. code-block:: console
+
+ $ curl -X DELETE http://127.0.0.1:7777/v1/primary/flow_rules/0/port_id/0
+
+Response
+~~~~~~~~
+
+.. _table_spp_ctl_primary_flow_delete:
+
+.. table:: Response params of flow deletion.
+
+ +------------+--------+----------------------------------------+
+ | Name | Type | Description |
+ | | | |
+ +============+========+========================================+
+ | result | string | Deletion result. |
+ +------------+--------+----------------------------------------+
+ | message | string | Additional information if any. |
+ +------------+--------+----------------------------------------+
+
+Response example
+~~~~~~~~~~~~~~~~
+
+.. code-block:: json
+
+ {
+ "result" : "success",
+ "message" : "Flow rule #0 destroyed"
+ }
--
2.17.1
next prev parent reply other threads:[~2020-03-27 4:57 UTC|newest]
Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <20200226113521.3787-1-x-fn-spp-ml@ntt-tx.co.jp>
2020-03-27 4:57 ` [spp] [PATCH v2 00/11] Add Hardware offload document x-fn-spp-ml
2020-03-27 4:57 ` [spp] [PATCH v2 01/11] docs: add support for rte_flow x-fn-spp-ml
2020-03-27 4:57 ` [spp] [PATCH v2 02/11] docs: add support of MLX5 PMD support in DPDK x-fn-spp-ml
2020-03-27 4:57 ` [spp] [PATCH v2 03/11] docs: change primary process startup parameter x-fn-spp-ml
2020-03-27 4:57 ` x-fn-spp-ml [this message]
2020-03-27 4:57 ` [spp] [PATCH v2 05/11] docs: support flow syntax in primary command x-fn-spp-ml
2020-03-27 4:57 ` [spp] [PATCH v2 06/11] docs: support multi-queue in spp_vf command x-fn-spp-ml
2020-03-27 4:57 ` [spp] [PATCH v2 07/11] docs: add svg for classify case of hardware offload x-fn-spp-ml
2020-03-27 4:57 ` [spp] [PATCH v2 08/11] docs: add svg for vlan " x-fn-spp-ml
2020-03-27 4:57 ` [spp] [PATCH v2 09/11] docs: add svg for vm " x-fn-spp-ml
2020-03-27 4:57 ` [spp] [PATCH v2 10/11] docs: add usecase for " x-fn-spp-ml
2020-03-27 4:57 ` [spp] [PATCH v2 11/11] docs: add install drivers for Mellanox NIC x-fn-spp-ml
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20200327045732.18463-5-x-fn-spp-ml@ntt-tx.co.jp \
--to=x-fn-spp-ml@ntt-tx.co.jp \
--cc=ferruh.yigit@intel.com \
--cc=spp@dpdk.org \
--cc=yasufum.o@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).