Page Comparison

Table of Contents

Overview

Jira LegacyserverSystem JiracolumnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolutioncolumnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolutionserverId4733707d-2057-3a0f-ae5e-4fd8aff50176keyCPS

Table of Contents

Overview

Jira Legacy

server	System Jira
columnIds	issuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columns	key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId	4733707d-2057-3a0f-ae5e-4fd8aff50176
key	CPS-1628

This page gives a description of CPS events including their fields
Events will be split into events and Headers

...

#	Short Name	Source	Destination	Impl. Status	Notes	Full Schema Name	Diagram Ref.
1	LCM Event	NCMP	Client Apps	In Use	Life Cycle Management Events, when cmHandles are added or removed	cps:org.onap.ncmp.cmhandle.lcm-event:v1	CM-Handle State Changes and Notifications Overview#Notificationhandlingincode
2	DMI Data AVC Event	DMI	NCMP	Implemented, Not in use	Attribute Value Change in configuration management (CM) data.	cps:org.onap.cps.ncmp.events:avc-event-schema:v1	5 in CPS Data Notifications Overview#ComponentDiagram
3	AVC Subscription Create Event	Client	NCMP & DMIs	Implemented, Not in use	Create Event Only	cps:org.onap.cps.ncmp.events:avc-subscription-event:v1	7 in CPS Data Notifications Overview#ComponentDiagram
4	DMI Async Request Response Event	DMI	NCMP	In Use	DMI passes response onto Kafka topic specified by client.	cps:org.onap.cps.ncmp.events:dmi-async-request-response-event-schema:v1	3b → 4a in CPS-821 Spike: Support Async read-write operations on CPS-NCMP interface#ProposedDesign
5	NCMP Async Request Response Event	NCMP	Client Apps	In Use	Forward No.4 to client specified topic	cps:org.onap.cps.ncmp.events:ncmp-async-request-response-event-schema:v1	4b → 5 in CPS-821 Spike: Support Async read-write operations on CPS-NCMP interface#ProposedDesign
6	Bulk Response Event (Internal)	DMI	NCMP	In Progress	Internal Kafka topic	cps:org.onap.cps.ncmp.event:dmi-async-bulk-response-event-schema:v1	5 in CPS-1515: Spike: Support Multiple CM-Handles for NCMP Get Operation (batch Data operations)#BulkRequestMessageFlow
7	Bulk Response Event (Client)	NCMP	Client Apps	In Progress	Forwarding the DMI responses to the client topic	cps:org.onap.cps.ncmp.event:ncmp-async-bulk-response-event-schema:v1	6 in CPS-1515: Spike: Support Multiple CM-Handles for NCMP Get Operation (batch Data operations)#BulkRequestMessageFlow

#1 LCM Event (NCMP → Client Apps)

...

This event is for the asynchronous responses from DMI to NCMP following (synchronous) requests (from NCMP) specifying a (response) topic. See 3b → 4a in CPS-821 Spike: Support Async read-write operations on CPS-NCMP interface#ProposedDesign

Expand

title	DMI Async Request Response Event

DmiAsyncRequestResponse Event Object

Field	Type	Description	Header	Notes	CloudEvents Mapping
eventID	string	The unique id identifying the event generated by DMI	X		standard (`id`)
eventCorrelationId	string	The request id passed by NCMP	X		extensions (`correlationid`)
eventTime	string	The timestamp when original event occurred	X		standard (`time`)
eventTarget	string	The target of the event	X		extensions (`target`)
eventType	string	The type of the event	X		standard (`type`)
eventSchema	string	The event schema for async request response events	X		standard (`dataschema`)
~~eventSchemaVersion~~	~~string~~	~~The event schema version for async request response events~~	X		~~N/A included in 'dataschema'~~
eventSource	string	The source of the event	X		standard (`source`)
eventContent	EventContent	The payload of an event		The name of this fields is inconsistent with all other event schemas, see issue #6	standard `(data)`

Type: EventContent (cps:org.onap.cps.ncmp.events:dmi-async-request-response-event-schema:v1)

Field	Type	Description	Payload	Notes
response-data-schema	string	The schema of response data	X
response-status	string	The status of the response	X
response-code	string	The code of the response	X
response-data	object	The data payload	X	contains payload of type object

...

This event is for the asynchronous responses from NCMP to Client Apps following (synchronous) requests (from client) specifying a (response) topic. See 4b → 5 in CPS-821 Spike: Support Async read-write operations on CPS-NCMP interface#ProposedDesign

Type: Event (cps:org.onap.cps.ncmp.events:ncmp-async-request-response-event-schema:v1)

see

Expand

title	NCMP Async Request Response Event

NcmpAsyncRequestResponse Event Object

Field	Type	Description	Header	Payload	Notes	CloudEvents Mapping
eventID	string	The unique id identifying the event generated by DMI	X			standard (`id`)
eventCorrelationId	string	The request id passed by NCMP	X			extensions (`correlationid`)
eventTime	string	The timestamp when original event occurred	X			standard (`time`)
eventTarget	string	The target of the event	X			extensions (`target`)
eventType	string	The type of the event	X			standard (`type`)
source	string	The source of the event	X		NEW see decision #18, value 'ncmp' TBC	standard (`source`)
eventSchema	string	The event schema for async request response events	X			standard (`dataschema`)
~~eventSchemaVersion~~	~~string~~	~~The event schema version for async request response events~~	X			~~N/A included in 'dataschema'~~
event	Event	The payload of an event		X	Defined by event object below	standard (`data`)
forwardedEvent	ForwardedEvent	The payload of a forwarded event		X	Relation to Event field unclear, do we need 2 events at all see issue #7	standard (`data`) See new proposal below

Type: Event (cps:org.onap.cps.ncmp.events:ncmp-async-request-response-event-schema:v1)

Field	Type	Description	Payload	Notes
eventID	string	The unique id identifying the event generated by DMI	X	Only in payload in v1 of the payload schema. To be removed in v2 version (will be in the header only)
eventCorrelationId	string	The request id passed by NCMP	X	as above
eventTime	string	The timestamp when original event occurred	X	as above
eventTarget	string	The target of the event	X	as above
eventType	string	The type of the event	X	as above
eventSchema	string	The event schema for async request response events	X	as above
eventSource	string	The source of the event	X	as above
response-data-schema	string	The received schema of response data	X
response-status	string	The received status of the response	X
response-code	string	The received code of the response	X
response-data	object	The data payload	X	contains payload of type object

Type: forwardedEvent (cps:org.onap.cps.ncmp.events:ncmp-async-request-response-event-schema:v1)

Field	Type	Description	Payload	Notes
eventID	string	The unique id identifying the event generated by DMI	?	Can NCMP put these in the header and remove them from the 'forwardedEvent'
eventCorrelationId	string	The request id passed by NCMP	?	as above
eventTime	string	The timestamp when original event occurred	?	as above
eventTarget	string	The target of the event	?	as above
eventType	string	The type of the event	?	as above
eventSchema	string	The event schema for async request response events	?	as above
eventSchemaVersion	string	The event schema version for async request response events	?	as above
eventSource	string	The source of the event	?	as above
response-data-schema	string	The received schema of response data	X
response-status	string	The received status of the response	X
response-code	string	The received code of the response	X
response-data	object	The data payload	X	contains payload of type object

Proposed New Schema:

eventType

string

The type of the event

X

standard (type)

eventSchema

string

The event schema for async request response events

X

standard (dataschema)

~~eventSchemaVersion~~

~~string~~

~~The event schema version for async request response events~~

X

~~N/A included in 'dataschema'~~

event

Event

The payload of an event

X

Defined by event object below

standard (data)

Jira Legacy

server	System Jira
serverId	4733707d-2057-3a0f-ae5e-4fd8aff50176
key	CPS-1660

FieldTypeDescriptionHeaderPayloadNotesCloudEvents MappingeventIDstringThe unique id identifying the event generated by DMIXstandard (id)eventCorrelationIdstring

The request id passed by NCMP

Xextensions(correlationid)eventTimestringThe timestamp when original event occurredXstandard (time)eventSourcestringThe source of the eventXWhat value should contain in this? Needs clarification, see issue #8standard (source)

	System Jira
serverId	4733707d-2057-3a0f-ae5e-4fd8aff50176
key	CPS-1660

Field	Type	Description	Header	Payload	Notes	CloudEvents Mapping
eventID	string	The unique id identifying the event generated by DMI	X			standard (`id`)
eventCorrelationId	string	The request id passed by NCMP	X			extensions(`correlationid`)
eventTime	string	The timestamp when original event occurred	X			standard (`time`)
eventSource	string	The source of the event	X		What value should contain in this? Needs clarification, see issue #8	standard (`source`)
eventType	string	The type of the event	X			standard (`type`)
eventSchema	string	The event schema for async request response events	X			standard (`dataschema`)
~~eventSchemaVersion~~	~~string~~	~~The event schema version for async request response events~~	X			~~N/A included in '`dataschema`'~~
event	Event	The payload of an event		X	Defined by event object below	standard (`data`)

Type: Event (cps:org.onap.cps.ncmp.events:ncmp-async-request-response-event-schema:v1)

Field	Type	Description	Header	Payload	Notes
eventCorrelationId	string	The request id passed by NCMP	X		as above @Toine asked to add this property.
responseStatus	string	The received status of the response		X
responseCode	string	The received code of the response		X
responseData	object	The data payload		X	contains payload of type object

#6 Data Operation (response) Event (DMI → NCMP)

Description

Batch (data) request will always result in asynchronous events (responses) sent to the client. This event is the response from DMI to NCMP. See 5 in CPS-1515: Spike: Support Multiple CM-Handles for NCMP Get Operation (bulk / batch operations)#BulkRequestMessageFlow

Expand

title	DMI Async Batch Response Event

DmiDataOperationEvent Object

Excerpt

Field	Type	Description	Header	Payload	Notes	CloudEvents Mapping
eventID	string	The unique id identifying the event generated by DMI	X		Mandatory. Generated by DMI-Plugin	standard (`id`)
eventCorrelationId	string	The request id passed by NCMP	X

as above @Toine asked to add this property.

responseStatus

string

The received status of the response

X

responseCode

string

The received code of the response

X

responseData

object

The data payload

X

contains payload of type object

#6 Batch Response Event (DMI → NCMP)

Description

Batch (data) request will always result in asynchronous events (responses) sent to the client. This event is the response from DMI to NCMP. See 5 in CPS-1515: Spike: Support Multiple CM-Handles for NCMP Get Operation (bulk / batch operations)#BulkRequestMessageFlow

...

title	DMI Async Batch Response Event

BatchResponseEvent Object

...

Mandatory. Generated by DMI-Plugin

...

The request id passed by NCMP

...

Optional. The timestamp should follow that on https://www.rfc-editor.org/rfc/rfc3339#section-5. This follows ISO 8601 and is what is used/referenced in 3GPP standards
example: 1985-04-12T23:20:50.52Z this represents 20 minutes and 50.52 seconds after the 23rd hour of April 12th, 1985 in UTC.

...

The event schema for async request response events

...

~~The event schema version for async request response events~~

...

Type: Event (cps:org.onap.cps.ncmp.event.async:dmi-async-batch-response-event-schema:v1)

...

#7 Batch Response Event (NCMP → Client App)

Description

Batch (data) request will always result in asynchronous events (responses) sent to the client. This event is the response from DMI to NCMP. See 6 in CPS-1515: Spike: Support Multiple CM-Handles for NCMP Get Operation (bulk / batch operations)#BulkRequestMessageFlow

...

title	NCMP Async Batch Response Event - Client Topic

BatchResponseEvent Object

...

The request id passed by NCMP

...

The event schema for async request response events

...

~~The event schema version for async request response events~~

...

Type: Event (cps:org.onap.cps.ncmp.event.async:ncmp-async-batch-response-event-schema:v1)

...

CNCF Cloud Event alignment

Introduction

Image Removed

CNCF CloudEvents is a specification for describing event data in common formats to provide interoperability across services, platforms and systems.

These cloud events will be applied to all the internal and external events we have in CPS , NCMP and DMI Plugin.
Cloud events will be taking care of the fields which are part of Headers or part of the actual payload (fields other than "data" are sent as Headers)
These CNCF cloud events will be applied to all the events listed in above sections (LCM , DMI Data AVC etc.)

Library References

Common Header Mapping

The table below shows how previously proposed headers should be mapped to pre-defined CNFC headers.

...

Before

...

After¹

...

eventId

...

(ce_)id

...

eventSource

...

(ce_)source

...

N/A

...

(ce_)specversion (default 1.0)

...

eventType

...

(ce_)type

...

eventTime

...

(ce_)time

...

eventSchema

...

(ce_)dataschema

...

Optional includes the version of the schema

...

withDataContentType()

...

Optional This will be part of the extensions field in the cloud events and all the restrictions of the attribute field naming applies to it.

i.e these fields will be in the small case.

This is marked as optional as it only applies to some events.

...

Mandatory. This is requestId that NCMP sent to client as an ACK. example : “request-1234" (UUID)	extension (`correlationid`)
eventTarget	string	The destination topic of the client	X		Mandatory. TBC example: my-topic	extension (`destination`)
source	string	The source of the event			Mandatory. example : dmi-plugin:enm-1 (dmi service name)	standard (`source`)
eventTime	string	The timestamp when original event occurred	X		Optional. The timestamp should follow that on https://www.rfc-editor.org/rfc/rfc3339#section-5. This follows ISO 8601 and is what is used/referenced in 3GPP standards example: 1985-04-12T23:20:50.52Z this represents 20 minutes and 50.52 seconds after the 23rd hour of April 12th, 1985 in UTC.	standard (`time`)
eventType	string	The type of the event	X		Mandatory. NCMP owns eventType that would be used by dmi-plugins The Convention of eventType and Schema names is under discussion, see open issue #17 on CPS-1515 Spike	standard (`type`)
eventSchema	string	The event schema for async request response events	X		Mandatory. The Convention of eventType and Schema names is under discussion, see open issue #17 on CPS-1515 Spike	standard (`dataschema`)
~~eventSchemaVersion~~	~~string~~	~~The event schema version for async request response events~~	X			~~N/A included in '`dataschema`'~~
event	Event	The payload of an event		X	java object not yet defined by schema, see issue #2	standard (`data`)
specversion	String	Version of CNCF spec	X		hardcoded value of 1.0	standard (`specversion`)

Type: Event (cps:org.onap.cps.ncmp.event.async:dmi-data-operation-event-schema:v1)

Field	Type	Description	Header	Payload	Notes
No Properties defined (Entire event treated as single object)

#7 Data Operation (response) Event (NCMP → Client App)

Description

Batch (data) request will always result in asynchronous events (responses) sent to the client. This event is the response from DMI to NCMP. See 6 in CPS-1515: Spike: Support Multiple CM-Handles for NCMP Get Operation (bulk / batch operations)#BulkRequestMessageFlow

Expand

title	NCMP Async Batch Response Event - Client Topic

NcmpDataOperationEvent Object

Field	Type	Description	Header	Payload	Notes	CloudEvents Mapping
eventID	string	The unique id identifying the event generated by DMI	X			standard (`id`)
eventCorrelationId	string	The request id passed by NCMP	X			extensions (`correlationid`)
eventTime	string	The timestamp when original event occurred	X			standard (`time`)
eventType	string	The type of the event	X			standard (`type`)
source	string	The source of the event	X		NEW see decision #18, value 'ncmp'	standard (`source`)
eventSchema	string	The event schema for async request response events	X			standard (`dataschema`)
~~eventSchemaVersion~~	~~string~~	~~The event schema version for async request response events~~	X			~~N/A included in '`dataschema`'~~
event	Event	The payload of an event		X	Java object not yet defined by schema, see issue #2	standard (`data`)

Type: Event (cps:org.onap.cps.ncmp.event.async:ncmp-data-operation-event-schema:v1)

Field	Type	Description	Header	Payload	Notes
No Properties defined (Entire event treated as single object)

CNCF Cloud Event alignment

Introduction

Image Added

CNCF CloudEvents is a specification for describing event data in common formats to provide interoperability across services, platforms and systems.

These cloud events will be applied to all the internal and external events we have in CPS , NCMP and DMI Plugin.
Cloud events will be taking care of the fields which are part of Headers or part of the actual payload (fields other than "data" are sent as Headers)
These CNCF cloud events will be applied to all the events listed in above sections (LCM , DMI Data AVC etc.)

Library References

Common Header Mapping

The table below shows how previously proposed headers should be mapped to pre-defined CNFC headers.

Before	After¹	CloudeEvent builder method	Example Value	Notes
eventId	(ce_)id	.withId()		Mandatory
eventSource	(ce_)source	.withSource()		Mandatory
N/A	(ce_)specversion (default 1.0)	.v1()	1.0	Mandatory - This is the version of the cloud events
eventType	(ce_)type	.withType()		Mandatory
eventTime	(ce_)time	.withTime()		Optional (could be Mandatory for
eventSchema	(ce_)dataschema	.withDataSchema()		Optional includes the version of the schema
	content-type²	withDataContentType()	application/json	Optional
eventCorrelationId	(ce_)correlationid	.withExtension()		Optional This will be part of the extensions field in the cloud events and all the restrictions of the attribute field naming applies to it. i.e these fields will be in the small case. This is marked as optional as it only applies to some events.
event	(ce_)data	.withData(json TBC)		Mandatory actual event/payload now would be under "data" field.

Note 1 all cloud-event headers will be prefixed during serialization with 'ce_' (this means when filtering on serialized Kafka-headers this prefix need to be applied)
Note 2 content-type is a a 'default' header name no 'wrapped' by CloudEvents and hence the inconsistency in names and that is does NOT have the 'ce_' prefix.

Common NCMP response staus code & message :

Status-code 0-99 is reserved for any success response
Status-code from 100 to 199 is reserved for any failed response.

Status Code	Status Message
0	Successfully applied changes
100	cm handle id(s) is(are) not found
101	cm handle id(s) is(are) in non ready state
102	dmi plugin service is not responding
103	dmi plugin service is not able to read resource data

Versions Compared

Old Version 124

New Version Current

Key

Overview

Overview

#1 LCM Event (NCMP → Client Apps)

Type: EventContent (cps:org.onap.cps.ncmp.events:dmi-async-request-response-event-schema:v1)

Type: Event (cps:org.onap.cps.ncmp.events:ncmp-async-request-response-event-schema:v1)

NcmpAsyncRequestResponse Event Object

Type: Event (cps:org.onap.cps.ncmp.events:ncmp-async-request-response-event-schema:v1)

Type: forwardedEvent (cps:org.onap.cps.ncmp.events:ncmp-async-request-response-event-schema:v1)

Proposed New Schema:

Type: Event (cps:org.onap.cps.ncmp.events:ncmp-async-request-response-event-schema:v1)

#6 Data Operation (response) Event (DMI → NCMP)

Description

#6 Batch Response Event (DMI → NCMP)

Description

#7 Batch Response Event (NCMP → Client App)

Description

CNCF Cloud Event alignment

Introduction

Library References

Common Header Mapping

#7 Data Operation (response) Event (NCMP → Client App)

Description

CNCF Cloud Event alignment

Introduction

Library References

Common Header Mapping

Common NCMP response staus code & message :