summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--docs/files/VESEventListener.rst1082
-rw-r--r--docs/files/marketplace-overview.rst2
-rw-r--r--docs/files/ves-providethrottlingstate.pngbin0 -> 24135 bytes
-rw-r--r--docs/files/ves-publishanyevent.pngbin0 -> 21976 bytes
-rw-r--r--docs/files/ves-publisheventbatch.pngbin0 -> 24618 bytes
-rw-r--r--docs/files/ves-rest-resource-structure.pngbin0 -> 13998 bytes
-rw-r--r--docs/index.rst14
-rw-r--r--docs/release-notes.rst16
8 files changed, 418 insertions, 696 deletions
diff --git a/docs/files/VESEventListener.rst b/docs/files/VESEventListener.rst
index 5cff4db..50743ad 100644
--- a/docs/files/VESEventListener.rst
+++ b/docs/files/VESEventListener.rst
@@ -103,39 +103,39 @@ Sample Request and Response
Sample Request
^^^^^^^^^^^^^^
-+---------------------------------------------------------------+
-| POST /eventListener/v5 HTTPS/1.1 |
-| Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== |
-| content-type: application/json |
-| content-length: 12345 |
-| { |
-| "event": { |
-| "commonEventHeader": { |
-| "version": 3.0, |
-| "domain": "heartbeat", |
-| "eventName": "Heartbeat\_vIsbcMmc", |
-| "eventId": "ab305d54-85b4-a31b-7db2fb6b9e546015", |
-| "sequence": 0, |
-| "priority": "Normal", |
-| "reportingEntityId": "cc305d54-75b4-431badb2eb6b9e541234",|
-| "reportingEntityName": "EricssonOamVf", |
-| "sourceId": "de305d54-75b4-431b-adb2-eb6b9e546014", |
-| "sourceName": "ibcx0001vm002ssc001", |
-| "nfNamingCode": "ibcx", |
-| "nfcNamingCode": "ssc", |
-| "startEpochMicrosec": 1413378172000000, |
-| "lastEpochMicrosec": 1413378172000000 |
-| } |
-| } |
-| } |
-+---------------------------------------------------------------+
+ .. code:: bash
+
+ POST /eventListener/v5 HTTPS/1.1
+ Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
+ content-type: application/json
+ content-length: 12345
+ {
+ "event": {
+ "commonEventHeader": {
+ "version": 3.0,
+ "domain": "heartbeat",
+ "eventName": "Heartbeat\_vIsbcMmc",
+ "eventId": "ab305d54-85b4-a31b-7db2fb6b9e546015",
+ "sequence": 0,
+ "priority": "Normal",
+ "reportingEntityId": "cc305d54-75b4-431badb2eb6b9e541234",
+ "reportingEntityName": "EricssonOamVf",
+ "sourceId": "de305d54-75b4-431b-adb2-eb6b9e546014",
+ "sourceName": "ibcx0001vm002ssc001",
+ "nfNamingCode": "ibcx",
+ "nfcNamingCode": "ssc",
+ "startEpochMicrosec": 1413378172000000,
+ "lastEpochMicrosec": 1413378172000000
+ }
+ }
+ }
Sample Success Response
^^^^^^^^^^^^^^^^^^^^^^^
-+--------------------------+
-| HTTPS/1.1 202 Accepted |
-+--------------------------+
+ .. code:: bash
+
+ HTTPS/1.1 202 Accepted
Resource Structure
==================
@@ -587,9 +587,7 @@ The diskUsage datatype defines the usage of a disk and consists of the following
+-----------------------------+----------+-------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| diskOctetsRead Avg | number | No | Number of octets per second read from a disk or partition; provide the average measurement within the measurement interval |
+-----------------------------+----------+-------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| diskOctetsRead | number | No | Number of octets per second read from a disk or partition; provide the last measurement within the measurement interval |
-| | | | |
-| Last | | | |
+| diskOctetsRead Last | number | No | Number of octets per second read from a disk or partition; provide the last measurement within the measurement interval |
+-----------------------------+----------+-------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| diskOctetsRead Max | number | No | Number of octets per second read from a disk or partition; provide the maximum measurement within the measurement interval |
+-----------------------------+----------+-------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -1480,7 +1478,7 @@ RESTful Web Services Definition
REST Operation Overview
-----------------------
-REST Operation Summary
+REST Operation Summary
~~~~~~~~~~~~~~~~~~~~~~~
+--------------------------------+------------+----------------------------------------------------------------------------+
@@ -1507,7 +1505,7 @@ older versions will break in some way, if they try to use the new API
without modification (e.g., unmodified v1 clients would not be able to
use v2 without error).
-Commands Toward Event Source Clients
+Commands Toward Event Source Clients
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Note: Vendors are not currently required to implement support for
@@ -1548,7 +1546,7 @@ currently supported:
| | - if suppressedNvPairsList is not provided, then any existing list of suppressed name-value pairs shall be discarded |
+-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-Buffering of Events
+Buffering of Events
~~~~~~~~~~~~~~~~~~~~
{ServerRoot} is defined in section 3 of this document, which defines the
@@ -1604,7 +1602,7 @@ Call Flow
|image1|
-Figure - publishAnyEvent Call Flow
+Figure 2 - publishAnyEvent Call Flow
Input Parameters
~~~~~~~~~~~~~~~~
@@ -1696,190 +1694,108 @@ Sample Request and Response
Sample Request
^^^^^^^^^^^^^^
-+-------------------------------------------------------------------------------+
-| POST /eventListener/v5 HTTPS/1.1 |
-| |
-| Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== |
-| |
-| content-type: application/json |
-| |
-| | content-length: 12345 |
-| | { |
-| |
-| "event": { |
-| |
-| "commonEventHeader": { |
-| |
-| "version": 3.0, |
-| |
-| "domain": "fault", |
-| |
-| "eventName": "Fault\_MobileCallRecording\_PilotNumberPoolExhaustion", |
-| |
-| "eventId": "ab305d54-85b4-a31b-7db2-fb6b9e546015", |
-| |
-| "sequence": 0, |
-| |
-| "priority": "High", |
-| |
-| "reportingEntityId": "cc305d54-75b4-431b-adb2-eb6b9e541234", |
-| |
-| "reportingEntityName": "EricssonOamVf", |
-| |
-| "sourceId": "de305d54-75b4-431b-adb2-eb6b9e546014", |
-| |
-| "sourceName": "scfx0001vm002cap001", |
-| |
-| "nfNamingCode": "scfx", |
-| |
-| "nfcNamingCode": "ssc", |
-| |
-| "startEpochMicrosec": 1413378172000000, |
-| |
-| "lastEpochMicrosec": 1413378172000000 |
-| |
-| }, |
-| |
-| "faultFields": { |
-| |
-| "faultFieldsVersion": 2.0, |
-| |
-| "alarmCondition": "PilotNumberPoolExhaustion", |
-| |
-| "eventSourceType": "other", |
-| |
-| "specificProblem": "Calls cannot complete - pilot numbers are unavailable", |
-| |
-| "eventSeverity": "CRITICAL", |
-| |
-| "vfStatus": "Active", |
-| |
-| "alarmAdditionalInformation": [ |
-| |
-| { |
-| |
-| "name": "PilotNumberPoolSize", |
-| |
-| "value": "1000" |
-| |
-| } |
-| |
-| ] |
-| |
-| } |
-| |
-| } |
-| |
-| } |
-+-------------------------------------------------------------------------------+
+ .. code:: bash
+ POST /eventListener/v5 HTTPS/1.1
+ Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
+ content-type: application/json
+ content-length: 12345
+ {
+ "event": {
+ "commonEventHeader": {
+ "version": 3.0,
+ "domain": "fault",
+ "eventName": Fault\_MobileCallRecording\_PilotNumberPoolExhaustion",
+ "eventId": "ab305d54-85b4-a31b-7db2-fb6b9e546015",
+ "sequence": 0,
+ "priority": "High",
+ "reportingEntityId": "cc305d54-75b4-431b-adb2-eb6b9e541234",
+ "reportingEntityName": "EricssonOamVf",
+ "sourceId": "de305d54-75b4-431b-adb2-eb6b9e546014",
+ "sourceName": "scfx0001vm002cap001",
+ "nfNamingCode": "scfx",
+ "nfcNamingCode": "ssc",
+ "startEpochMicrosec": 1413378172000000,
+ "lastEpochMicrosec": 1413378172000000
+ },
+ "faultFields": {
+ "faultFieldsVersion": 2.0,
+ "alarmCondition": "PilotNumberPoolExhaustion",
+ "eventSourceType": "other",
+ "specificProblem": "Calls cannot complete - pilot numbers are unavailable",
+ "eventSeverity": "CRITICAL",
+ "vfStatus": "Active",
+ "alarmAdditionalInformation": [
+ {
+ "name": "PilotNumberPoolSize",
+ "value": "1000"
+ }
+ ]
+ }
+ }
+ }
Sample Success Response #1
^^^^^^^^^^^^^^^^^^^^^^^^^^
For success responses without a provided command list:
-+--------------------------+
-| HTTPS/1.1 202 Accepted |
-+--------------------------+
+ .. code:: bash
+
+ HTTPS/1.1 202 Accepted
Sample Success Response #2
^^^^^^^^^^^^^^^^^^^^^^^^^^
For success responses with a provided command list:
-+-----------------------------------------------------------------+
-| HTTPS/1.1 202 Accepted |
-| |
-| content-type: application/json |
-| |
-| content-length: nnn |
-| |
-| date: Sat, 04 Jul 2015 02:03:15 GMT |
-| |
-| { |
-| |
-| "commandList": [ |
-| |
-| { |
-| |
-| "commandType": "throttlingSpecification", |
-| |
-| "eventDomainThrottleSpecification": { |
-| |
-| "eventDomain": "fault", |
-| |
-| "suppressedFieldNames": [ |
-| |
-| "alarmInterfaceA", |
-| |
-| "alarmAdditionalInformation" |
-| |
-| ] |
-| |
-| } |
-| |
-| }, |
-| |
-| { |
-| |
-| "commandType": "throttlingSpecification", |
-| |
-| "eventDomainThrottleSpecification": { |
-| |
-| "eventDomain": "thresholdCrossingAlert", |
-| |
-| "suppressedFieldNames": [ |
-| |
-| "associatedAlertIdList", |
-| |
-| "possibleRootCause" |
-| |
-| ], |
-| |
-| "suppressedNvPairs" { |
-| |
-| "nvPairFieldName": additionalParameters", |
-| |
-| "suppressedNvPairNames": [ |
-| |
-| "someCounterName", |
-| |
-| "someOtherCounterName" |
-| |
-| ] |
-| |
-| } |
-| |
-| } |
-| |
-| }, |
-| |
-| { |
-| |
-| "commandType": "measurementIntervalChange", |
-| |
-| "measurementInterval": 600 |
-| |
-| }, |
-| |
-| { |
-| |
-| "commandType": "heartbeatIntervalChange", |
-| |
-| "heartbeatInterval": 90 |
-| |
-| }, |
-| |
-| { |
-| |
-| "commandType": "provideThrottlingState" |
-| |
-| } |
-| |
-| ] |
-| |
-| } |
-+-----------------------------------------------------------------+
+ .. code:: bash
+
+ HTTPS/1.1 202 Accepted
+ content-type: application/json
+ content-length: nnn
+ date: Sat, 04 Jul 2015 02:03:15 GMT
+ {
+ "commandList": [
+ {
+ "commandType": "throttlingSpecification",
+ "eventDomainThrottleSpecification": {
+ "eventDomain": "fault",
+ "suppressedFieldNames": [
+ "alarmInterfaceA",
+ "alarmAdditionalInformation"
+ ]
+ }
+ },
+ {
+ "commandType": "throttlingSpecification",
+ "eventDomainThrottleSpecification": {
+ "eventDomain": "thresholdCrossingAlert",
+ "suppressedFieldNames": [
+ "associatedAlertIdList",
+ "possibleRootCause"
+ ],
+ "suppressedNvPairs" {
+ "nvPairFieldName": additionalParameters",
+ "suppressedNvPairNames": [
+ "someCounterName",
+ "someOtherCounterName"
+ ]
+ }
+ }
+ },
+ {
+ "commandType": "measurementIntervalChange",
+ "measurementInterval": 600
+ },
+ {
+ "commandType": "heartbeatIntervalChange",
+ "heartbeatInterval": 90
+ },
+ {
+ "commandType": "provideThrottlingState"
+ }
+ ]
+ }
1. .. rubric:: Sample Error Responses
:name: sample-error-responses
@@ -1887,68 +1803,42 @@ Sample Success Response #2
1. .. rubric:: Sample Policy Exception
:name: sample-policy-exception
-+---------------------------------------------------------------+
-| HTTPS/1.1 400 Bad Request |
-| |
-| content-type: application/json |
-| |
-| content-length: 12345 |
-| |
-| Date: Thu, 04 Jun 2009 02:51:59 GMT |
-| |
-| { |
-| |
-| "requestError": { |
-| |
-| "policyException": { |
-| |
-| "messageId": "POL9003", |
-| |
-| "text": "Message content size exceeds the allowable limit", |
-| |
-| } |
-| |
-| } |
-| |
-| } |
-+---------------------------------------------------------------+
+ .. code:: bash
+
+ HTTPS/1.1 400 Bad Request
+ content-type: application/json
+ content-length: 12345
+ Date: Thu, 04 Jun 2009 02:51:59 GMT
+ {
+ "requestError": {
+ "policyException": {
+ "messageId": "POL9003",
+ "text": "Message content size exceeds the allowable limit",
+ }
+ }
+ }
Sample Service Exception
''''''''''''''''''''''''
-+-----------------------------------------------------+
-| HTTPS/1.1 400 Bad Request |
-| |
-| content-type: application/json |
-| |
-| content-length: 12345 |
-| |
-| Date: Thu, 04 Jun 2009 02:51:59 GMT |
-| |
-| { |
-| |
-| "requestError": { |
-| |
-| "serviceException": { |
-| |
-| "messageId": "SVC2000", |
-| |
-| "text": "Missing Parameter: %1. Error code is %2" |
-| |
-| "variables": [ |
-| |
-| "severity", |
-| |
-| "400" |
-| |
-| ] |
-| |
-| } |
-| |
-| } |
-| |
-| } |
-+-----------------------------------------------------+
+ .. code:: bash
+
+ HTTPS/1.1 400 Bad Request
+ content-type: application/json
+ content-length: 12345
+ Date: Thu, 04 Jun 2009 02:51:59 GMT
+ {
+ "requestError": {
+ "serviceException": {
+ "messageId": "SVC2000",
+ "text": "Missing Parameter: %1. Error code is %2"
+ "variables": [
+ "severity",
+ "400"
+ ]
+ }
+ }
+ }
Operation: publishEventBatch
----------------------------
@@ -1976,7 +1866,7 @@ Call Flow
|image2|
-Figure " publishEventBatch Call Flow
+Figure 3 publishEventBatch Call Flow
Input Parameters
~~~~~~~~~~~~~~~~
@@ -2068,246 +1958,137 @@ Sample Request and Response
Sample Request
^^^^^^^^^^^^^^
-+-------------------------------------------------------------------------------+
-| POST /eventListener/v5/eventBatch HTTPS/1.1 |
-| |
-| Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== |
-| |
-| content-type: application/json |
-| |
-| | content-length: 12345 |
-| | { |
-| |
-| "eventList": [ |
-| |
-| { |
-| |
-| "commonEventHeader": { |
-| |
-| "version": 3.0, |
-| |
-| "domain": "fault", |
-| |
-| "eventName": "Fault\_MobileCallRecording\_PilotNumberPoolExhaustion", |
-| |
-| "eventId": "ab305d54-85b4-a31b-7db2-fb6b9e546015", |
-| |
-| "sequence": 0, |
-| |
-| "priority": "High", |
-| |
-| "reportingEntityId": "cc305d54-75b4-431b-adb2-eb6b9e541234", |
-| |
-| "reportingEntityName": "EricssonOamVf", |
-| |
-| "sourceId": "de305d54-75b4-431b-adb2-eb6b9e546014", |
-| |
-| "sourceName": "scfx0001vm002cap001", |
-| |
-| "nfNamingCode": "scfx", |
-| |
-| "nfcNamingCode": "ssc", |
-| |
-| "startEpochMicrosec": 1413378172000000, |
-| |
-| "lastEpochMicrosec": 1413378172000000 |
-| |
-| }, |
-| |
-| "faultFields": { |
-| |
-| "faultFieldsVersion": 2.0, |
-| |
-| "alarmCondition": "PilotNumberPoolExhaustion", |
-| |
-| "eventSourceType": "other", |
-| |
-| "specificProblem": "Calls cannot complete - pilot numbers are unavailable", |
-| |
-| "eventSeverity": "CRITICAL", |
-| |
-| "vfStatus": "Active", |
-| |
-| "alarmAdditionalInformation": [ |
-| |
-| { |
-| |
-| "name": "PilotNumberPoolSize", |
-| |
-| "value": "1000" |
-| |
-| } |
-| |
-| ] |
-| |
-| } |
-| |
-| }, |
-| |
-| { |
-| |
-| "commonEventHeader": { |
-| |
-| "version": 3.0, |
-| |
-| "domain": "fault", |
-| |
-| "eventName": "Fault\_MobileCallRecording\_RecordingServerUnreachable", |
-| |
-| "eventId": "ab305d54-85b4-a31b-7db2-fb6b9e546025", |
-| |
-| "sequence": 0, |
-| |
-| "priority": "High", |
-| |
-| "reportingEntityId": "cc305d54-75b4-431b-adb2-eb6b9e541234", |
-| |
-| "reportingEntityName": "EricssonOamVf", |
-| |
-| "sourceId": "de305d54-75b4-431b-adb2-eb6b9e546014", |
-| |
-| "sourceName": "scfx0001vm002cap001", |
-| |
-| "nfNamingCode": "scfx", |
-| |
-| "nfcNamingCode": "ssc", |
-| |
-| "startEpochMicrosec": 1413378172000010, |
-| |
-| "lastEpochMicrosec": 1413378172000010 |
-| |
-| }, |
-| |
-| "faultFields": { |
-| |
-| "faultFieldsVersion": 2.0, |
-| |
-| "alarmCondition": "RecordingServerUnreachable", |
-| |
-| "eventSourceType": "other", |
-| |
-| "specificProblem": "Recording server unreachable", |
-| |
-| "eventSeverity": "CRITICAL", |
-| |
-| "vfStatus": "Active" |
-| |
-| } |
-| |
-| } |
-| |
-| ] |
-| |
-| } |
-+-------------------------------------------------------------------------------+
+ .. code:: bash
+
+ POST /eventListener/v5/eventBatch HTTPS/1.1
+ Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
+ content-type: application/json
+ content-length: 12345
+ {
+ "eventList": [
+ {
+ "commonEventHeader": {
+ "version": 3.0,
+ "domain": "fault",
+ "eventName": "Fault\_MobileCallRecording\_PilotNumberPoolExhaustion",
+ "eventId": "ab305d54-85b4-a31b-7db2-fb6b9e546015",
+ "sequence": 0,
+ "priority": "High",
+ "reportingEntityId": "cc305d54-75b4-431b-adb2-eb6b9e541234",
+ "reportingEntityName": "EricssonOamVf",
+ "sourceId": "de305d54-75b4-431b-adb2-eb6b9e546014",
+ "sourceName": "scfx0001vm002cap001",
+ "nfNamingCode": "scfx",
+ "nfcNamingCode": "ssc",
+ "startEpochMicrosec": 1413378172000000,
+ "lastEpochMicrosec": 1413378172000000
+ },
+ "faultFields": {
+ "faultFieldsVersion": 2.0,
+ "alarmCondition": "PilotNumberPoolExhaustion",
+ "eventSourceType": "other",
+ "specificProblem": "Calls cannot complete - pilot numbers are unavailable",
+ "eventSeverity": "CRITICAL",
+ "vfStatus": "Active",
+ "alarmAdditionalInformation": [
+ {
+ "name": "PilotNumberPoolSize",
+ "value": "1000"
+ }
+ ]
+ }
+ },
+ {
+ "commonEventHeader": {
+ "version": 3.0,
+ "domain": "fault",
+ "eventName": "Fault\_MobileCallRecording\_RecordingServerUnreachable",
+ "eventId": "ab305d54-85b4-a31b-7db2-fb6b9e546025",
+ "sequence": 0,
+ "priority": "High",
+ "reportingEntityId": "cc305d54-75b4-431b-adb2-eb6b9e541234",
+ "reportingEntityName": "EricssonOamVf",
+ "sourceId": "de305d54-75b4-431b-adb2-eb6b9e546014",
+ "sourceName": "scfx0001vm002cap001",
+ "nfNamingCode": "scfx",
+ "nfcNamingCode": "ssc",
+ "startEpochMicrosec": 1413378172000010,
+ "lastEpochMicrosec": 1413378172000010
+ },
+ "faultFields": {
+ "faultFieldsVersion": 2.0,
+ "alarmCondition": "RecordingServerUnreachable",
+ "eventSourceType": "other",
+ "specificProblem": "Recording server unreachable",
+ "eventSeverity": "CRITICAL",
+ "vfStatus": "Active"
+ }
+ }
+ ]
+ }
Sample Success Response #1
^^^^^^^^^^^^^^^^^^^^^^^^^^
For success responses without a provided commandList:
-+--------------------------+
-| HTTPS/1.1 202 Accepted |
-+--------------------------+
+ .. code:: bash
+
+ HTTPS/1.1 202 Accepted
Sample Success Response #2
^^^^^^^^^^^^^^^^^^^^^^^^^^
For success responses with a provided commandList:
-+-----------------------------------------------------------------+
-| HTTPS/1.1 202 Accepted |
-| |
-| content-type: application/json |
-| |
-| content-length: nnn |
-| |
-| date: Sat, 04 Jul 2015 02:03:15 GMT |
-| |
-| { |
-| |
-| "commandList": [ |
-| |
-| { |
-| |
-| "commandType": "throttlingSpecification", |
-| |
-| "eventDomainThrottleSpecification": { |
-| |
-| "eventDomain": "fault", |
-| |
-| "suppressedFieldNames": [ |
-| |
-| "alarmInterfaceA", |
-| |
-| "alarmAdditionalInformation" |
-| |
-| ] |
-| |
-| } |
-| |
-| }, |
-| |
-| { |
-| |
-| "commandType": "throttlingSpecification", |
-| |
-| "eventDomainThrottleSpecification": { |
-| |
-| "eventDomain": "thresholdCrossingAlert", |
-| |
-| "suppressedFieldNames": [ |
-| |
-| "associatedAlertIdList", |
-| |
-| "possibleRootCause" |
-| |
-| ], |
-| |
-| "suppressedNvPairs" { |
-| |
-| "nvPairFieldName": additionalParameters", |
-| |
-| "suppressedNvPairNames": [ |
-| |
-| "someCounterName", |
-| |
-| "someOtherCounterName" |
-| |
-| ] |
-| |
-| } |
-| |
-| } |
-| |
-| }, |
-| |
-| { |
-| |
-| "commandType": "measurementIntervalChange", |
-| |
-| "measurementInterval": 600 |
-| |
-| }, |
-| |
-| { |
-| |
-| "commandType": "heartbeatIntervalChange", |
-| |
-| "heartbeatInterval": 90 |
-| |
-| }, |
-| |
-| { |
-| |
-| "commandType": "provideThrottlingState" |
-| |
-| } |
-| |
-| ] |
-| |
-| } |
-+-----------------------------------------------------------------+
+ .. code:: bash
+
+ HTTPS/1.1 202 Accepted
+ content-type: application/json
+ content-length: nnn
+ date: Sat, 04 Jul 2015 02:03:15 GMT
+ {
+ "commandList": [
+ {
+ "commandType": "throttlingSpecification",
+ "eventDomainThrottleSpecification": {
+ "eventDomain": "fault",
+ "suppressedFieldNames": [
+ "alarmInterfaceA",
+ "alarmAdditionalInformation"
+ ]
+ }
+ },
+ {
+ "commandType": "throttlingSpecification",
+ "eventDomainThrottleSpecification": {
+ "eventDomain": "thresholdCrossingAlert",
+ "suppressedFieldNames": [
+ "associatedAlertIdList",
+ "possibleRootCause"
+ ],
+ "suppressedNvPairs" {
+ "nvPairFieldName": additionalParameters",
+ "suppressedNvPairNames": [
+ "someCounterName",
+ "someOtherCounterName"
+ ]
+ }
+ }
+ },
+ {
+ "commandType": "measurementIntervalChange",
+ "measurementInterval": 600
+ },
+ {
+ "commandType": "heartbeatIntervalChange",
+ "heartbeatInterval": 90
+ },
+ {
+ "commandType": "provideThrottlingState"
+ }
+ ]
+ }
1. .. rubric:: Sample Error Responses
:name: sample-error-responses-1
@@ -2315,68 +2096,42 @@ Sample Success Response #2
1. .. rubric:: Sample Policy Exception
:name: sample-policy-exception-1
-+---------------------------------------------------------------+
-| HTTPS/1.1 400 Bad Request |
-| |
-| content-type: application/json |
-| |
-| content-length: 12345 |
-| |
-| Date: Thu, 04 Jun 2009 02:51:59 GMT |
-| |
-| { |
-| |
-| "requestError": { |
-| |
-| "policyException": { |
-| |
-| "messageId": "POL9003", |
-| |
-| "text": "Message content size exceeds the allowable limit", |
-| |
-| } |
-| |
-| } |
-| |
-| } |
-+---------------------------------------------------------------+
+ .. code:: bash
+
+ HTTPS/1.1 400 Bad Request
+ content-type: application/json
+ content-length: 12345
+ Date: Thu, 04 Jun 2009 02:51:59 GMT
+ {
+ "requestError": {
+ "policyException": {
+ "messageId": "POL9003",
+ "text": "Message content size exceeds the allowable limit",
+ }
+ }
+ }
Sample Service Exception
''''''''''''''''''''''''
-+-----------------------------------------------------+
-| HTTPS/1.1 400 Bad Request |
-| |
-| content-type: application/json |
-| |
-| content-length: 12345 |
-| |
-| Date: Thu, 04 Jun 2009 02:51:59 GMT |
-| |
-| { |
-| |
-| "requestError": { |
-| |
-| "serviceException": { |
-| |
-| "messageId": "SVC2000", |
-| |
-| "text": "Missing Parameter: %1. Error code is %2" |
-| |
-| "variables": [ |
-| |
-| "severity", |
-| |
-| "400" |
-| |
-| ] |
-| |
-| } |
-| |
-| } |
-| |
-| } |
-+-----------------------------------------------------+
+ .. code:: bash
+
+ HTTPS/1.1 400 Bad Request
+ content-type: application/json
+ content-length: 12345
+ Date: Thu, 04 Jun 2009 02:51:59 GMT
+ {
+ "requestError": {
+ "serviceException": {
+ "messageId": "SVC2000",
+ "text": "Missing Parameter: %1. Error code is %2"
+ "variables": [
+ "severity",
+ "400"
+ ]
+ }
+ }
+ }
Operation: provideThrottlingState
---------------------------------
@@ -2402,7 +2157,7 @@ Call Flow
|image3|
-Figure - provideClientThrottlingState Call Flow
+Figure 4 - provideClientThrottlingState Call Flow
Input Parameters
~~~~~~~~~~~~~~~~
@@ -2486,84 +2241,50 @@ Sample Request and Response
Sample Request
^^^^^^^^^^^^^^
-+----------------------------------------------------------+
-| POST /eventListener/v5/clientThrottlingState HTTPS/1.1 |
-| |
-| Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== |
-| |
-| content-type: application/json |
-| |
-| content-length: nnn |
-| |
-| accept: application/json |
-| |
-| { |
-| |
-| "eventThrottlingState": { |
-| |
-| "eventThrottlingMode": "throttled", |
-| |
-| "eventDomainThrottleSpecificationList": [ |
-| |
-| { |
-| |
-| "eventDomain": "fault", |
-| |
-| "suppressedFieldNames": [ |
-| |
-| "alarmInterfaceA", |
-| |
-| "alarmAdditionalInformation" |
-| |
-| ] |
-| |
-| }, |
-| |
-| { |
-| |
-| "eventDomain": "thresholdCrossingAlert", |
-| |
-| "suppressedFieldNames": [ |
-| |
-| "associatedAlertIdList", |
-| |
-| "possibleRootCause" |
-| |
-| ], |
-| |
-| "suppressedNvPairsList": [ |
-| |
-| { |
-| |
-| "nvPairFieldName": "additionalParameters", |
-| |
-| "suppressedNvPairNames": [ |
-| |
-| "someCounterName", |
-| |
-| "someOtherCounterName" |
-| |
-| ] |
-| |
-| } |
-| |
-| ] |
-| |
-| } |
-| |
-| ] |
-| |
-| } |
-| |
-| } |
-+----------------------------------------------------------+
+ .. code:: bash
+
+ POST /eventListener/v5/clientThrottlingState HTTPS/1.1
+ Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
+ content-type: application/json
+ content-length: nnn
+ accept: application/json
+ {
+ "eventThrottlingState": {
+ "eventThrottlingMode": "throttled",
+ "eventDomainThrottleSpecificationList": [
+ {
+ "eventDomain": "fault",
+ "suppressedFieldNames": [
+ "alarmInterfaceA",
+ "alarmAdditionalInformation"
+ ]
+ },
+ {
+ "eventDomain": "thresholdCrossingAlert",
+ "suppressedFieldNames": [
+ "associatedAlertIdList",
+ "possibleRootCause"
+ ],
+ "suppressedNvPairsList": [
+ {
+ "nvPairFieldName": "additionalParameters",
+ "suppressedNvPairNames": [
+ "someCounterName",
+ "someOtherCounterName"
+ ]
+ }
+ ]
+ }
+ ]
+ }
+ }
Sample Success Response
^^^^^^^^^^^^^^^^^^^^^^^
-+----------------------------+
-| HTTPS/1.1 204 No Content |
-+----------------------------+
+ .. code:: bash
+
+ HTTPS/1.1 204 No Content
1. .. rubric:: Sample Error Responses
:name: sample-error-responses-2
@@ -2571,70 +2292,55 @@ Sample Success Response
1. .. rubric:: Sample Policy Exception
:name: sample-policy-exception-2
-+---------------------------------------------------------------+
-| HTTPS/1.1 400 Bad Request |
-| |
-| content-type: application/json |
-| |
-| content-length: 12345 |
-| |
-| Date: Thu, 04 Jun 2009 02:51:59 GMT |
-| |
-| { |
-| |
-| "requestError": { |
-| |
-| "policyException": { |
-| |
-| "messageId": "POL9003", |
-| |
-| "text": "Message content size exceeds the allowable limit", |
-| |
-| } |
-| |
-| } |
-| |
-| } |
-+---------------------------------------------------------------+
+ .. code:: bash
+
+ HTTPS/1.1 400 Bad Request
+ content-type: application/json
+ content-length: 12345
+ Date: Thu, 04 Jun 2009 02:51:59 GMT
+ {
+ "requestError": {
+ "policyException": {
+ "messageId": "POL9003",
+ "text": "Message content size exceeds the allowable limit",
+ }
+ }
+ }
Sample Service Exception
''''''''''''''''''''''''
-+-----------------------------------------------------+
-| HTTPS/1.1 400 Bad Request |
-| |
-| content-type: application/json |
-| |
-| content-length: 12345 |
-| |
-| Date: Thu, 04 Jun 2009 02:51:59 GMT |
-| |
-| { |
-| |
-| "requestError": { |
-| |
-| "serviceException": { |
-| |
-| "messageId": "SVC2000", |
-| |
-| "text": "Missing Parameter: %1. Error code is %2" |
-| |
-| "variables": [ |
-| |
-| "severity", |
-| |
-| "400" |
-| |
-| ] |
-| |
-| } |
-| |
-| } |
-| |
-| } |
-+-----------------------------------------------------+
-
-
+ .. code:: bash
+
+ HTTPS/1.1 400 Bad Request
+ content-type: application/json
+ content-length: 12345
+ Date: Thu, 04 Jun 2009 02:51:59 GMT
+ {
+ "requestError": {
+ "serviceException": {
+ "messageId": "SVC2000",
+ "text": "Missing Parameter: %1. Error code is %2"
+ "variables": [
+ "severity",
+ "400"
+ ]
+ }
+ }
+ }
+
+.. |image0| image:: ves-rest-resource-structure.png
+ :height: 600px
+ :width: 800px
+.. |image1| image:: ves-publishanyevent.png
+ :height: 600px
+ :width: 800px
+.. |image2| image:: ves-publisheventbatch.png
+ :height: 600px
+ :width: 800px
+.. |image3| image:: ves-providethrottlingstate.png
+ :height: 600px
+ :width: 800px
diff --git a/docs/files/marketplace-overview.rst b/docs/files/marketplace-overview.rst
index bf4d8e4..91c97c2 100644
--- a/docs/files/marketplace-overview.rst
+++ b/docs/files/marketplace-overview.rst
@@ -11,7 +11,7 @@ into ONAP.
|image0|
-.. |image0| image:: vnfsdk-marketplace.png
+.. |image0| image:: files/vnfsdk-marketplace.png
:height: 600px
:width: 800px
diff --git a/docs/files/ves-providethrottlingstate.png b/docs/files/ves-providethrottlingstate.png
new file mode 100644
index 0000000..d7081df
--- /dev/null
+++ b/docs/files/ves-providethrottlingstate.png
Binary files differ
diff --git a/docs/files/ves-publishanyevent.png b/docs/files/ves-publishanyevent.png
new file mode 100644
index 0000000..c143079
--- /dev/null
+++ b/docs/files/ves-publishanyevent.png
Binary files differ
diff --git a/docs/files/ves-publisheventbatch.png b/docs/files/ves-publisheventbatch.png
new file mode 100644
index 0000000..c0bbde7
--- /dev/null
+++ b/docs/files/ves-publisheventbatch.png
Binary files differ
diff --git a/docs/files/ves-rest-resource-structure.png b/docs/files/ves-rest-resource-structure.png
new file mode 100644
index 0000000..df7674f
--- /dev/null
+++ b/docs/files/ves-rest-resource-structure.png
Binary files differ
diff --git a/docs/index.rst b/docs/index.rst
index f5dbab4..61664e9 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -64,15 +64,19 @@ client side API language bindings to define the VNF product model and package
content. The following tools are included...
• VNF Package Builder - creates a CSAR file based on inputs provided by the VNF
-product DevOps engineer
+ product DevOps engineer
+
• VNF Package Validator - validates the content of the VNF packages to ensure
-that everything has been built correctly
+ that everything has been built correctly
+
• VNF Package Extractor - extracts VNF product model and executables from the
-CSAR file
+ CSAR file
+
• VNF Package Parser - translates VNF proeduct blueprint into a format
-consumable by ONAP components
+ consumable by ONAP components
+
• VNF Package Dry Run - performs a "dry run" install to ensure that the package
-can be deployed during instantiation
+ can be deployed during instantiation
User Guides
diff --git a/docs/release-notes.rst b/docs/release-notes.rst
index 8e92725..fe7f728 100644
--- a/docs/release-notes.rst
+++ b/docs/release-notes.rst
@@ -37,14 +37,26 @@ It provides:
VNF SDK works with SDC to facilitate VNF Onboarding.
**Bug Fixes**
+
N/A
+
**Known Issues**
-N/A
+
+VNFSDK-126: The service 'GET /packageresource/csrs' ignores query parameters
+
**Security Issues**
+
N/A
+
**Upgrade Notes**
+
N/A
+
**Deprecation Notes**
+
N/A
+
**Other**
-N/A
+
+VNF onboarding with SDC is manual in Amsterdam.
+