From 861678290e4da598301c381b9ecb1c060c5b8d80 Mon Sep 17 00:00:00 2001 From: "Lovett, Trevor" Date: Wed, 25 Mar 2020 15:44:47 -0500 Subject: Fixed PublishEventBatch diagram in VES spec Since we no longer have the source images, I've converted them to either diagrams generated from Sphinx plugins or simple text representations. Issue-ID: VNFRQTS-862 Signed-off-by: Lovett, Trevor Change-Id: Iafd346336ca8b5cec71bbeee9fad825da2a5d0bf --- docs/Chapter8/publish-event-flow.png | Bin 8505 -> 0 bytes docs/Chapter8/rest-resource.png | Bin 4438 -> 0 bytes docs/Chapter8/ves7_1spec.rst | 46 +++++++++++++++++++++++++---------- 3 files changed, 33 insertions(+), 13 deletions(-) delete mode 100644 docs/Chapter8/publish-event-flow.png delete mode 100644 docs/Chapter8/rest-resource.png (limited to 'docs/Chapter8') diff --git a/docs/Chapter8/publish-event-flow.png b/docs/Chapter8/publish-event-flow.png deleted file mode 100644 index 3ae9c05..0000000 Binary files a/docs/Chapter8/publish-event-flow.png and /dev/null differ diff --git a/docs/Chapter8/rest-resource.png b/docs/Chapter8/rest-resource.png deleted file mode 100644 index ecfad9c..0000000 Binary files a/docs/Chapter8/rest-resource.png and /dev/null differ diff --git a/docs/Chapter8/ves7_1spec.rst b/docs/Chapter8/ves7_1spec.rst index 44b3725..83829ae 100644 --- a/docs/Chapter8/ves7_1spec.rst +++ b/docs/Chapter8/ves7_1spec.rst @@ -607,12 +607,15 @@ REST resources are defined with respect to a ServerRoot: ServerRoot = https://{Domain|IP}:{Port}/{optionalRoutingPath} -The resource structure is provided below: +The resource structure is provided below:: -.. figure:: rest-resource.png - :alt: REST Resource Structure + {ServerRoot} + | + |--- /eventListener/v{apiVersion} + | + |--- /eventBatch - REST Resource Structure +**Figure 1**: REST Resource Structure The {Port} above is typically 8443. @@ -3686,8 +3689,8 @@ Message Size The maximum allowed message size is 2 megabytes of uncompressed text. However,messages of this size have been known to cause performance and data loss. It is strongly recommended,that messages not exceed 1 megabyte. -In a future version of the specification, a 1 megabyte limit will become -a mandatory requirement. +In a future version of the specification, a 1 megabyte limit will become +a mandatory requirement. Operation: publishAnyEvent ~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -3710,10 +3713,17 @@ listener. Call Flow ++++++++++ -.. figure:: publish-event-flow.png - :alt: publishAnyEvent Call Flow +.. seqdiag:: + :caption: ``publishAnyEvent`` Call Flow - ``publishAnyEvent`` Call Flow + seqdiag { + edge_length = 250; + client -> listener [label = "POST /eventlistener/v7"]; + client <- listener [label = "HTTP 202 Accepted", note = "sync response"]; + === Error Scenario === + client -> listener [label = "POST /eventlistener/v7"]; + client <- listener [label = "HTTP 4XX/5XX", note = "sync response"]; + } Input Parameters +++++++++++++++++ @@ -3940,7 +3950,7 @@ Sample Service Exception X-MinorVersion: 1 X-PatchVersion: 1 X-LatestVersion: 7.1.1 - + { "requestError": { "serviceException": { @@ -3975,10 +3985,17 @@ listener. Call Flow +++++++++++ -.. figure:: publish-event-flow.png - :alt: publishEvent Call Flow +.. seqdiag:: + :caption: ``publishEventBatch`` Call Flow - ``publishEventBatch`` Call Flow + seqdiag { + edge_length = 250; + client -> listener [label = "POST /eventlistener/v7/eventBatch"]; + client <- listener [label = "HTTP 202 Accepted", note = "sync response"]; + === Error Scenario === + client -> listener [label = "POST /eventlistener/v7/eventBatch"]; + client <- listener [label = "HTTP 4XX/5XX", note = "sync response"]; + } Input Parameters +++++++++++++++++ @@ -6193,6 +6210,9 @@ Contents. | | | * Changed measValues to measValuesList and similar | | | | changes throughout | | | | * Changed iMeasTypesList to sMeasTypesList | +| | | - Corrected publishEventBatch call flow diagram | +| | | - Changed AuthorizationHeader to Required? = NO for | +| | | publishAnyEvent operation | +-----------+---------+-------------------------------------------------------+ .. _time_zone_abbreviations: https://en.wikipedia.org/wiki/List_of_time_zone_abbreviations -- cgit 1.2.3-korg