Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Assumptions

#AssumptionNotes
1Message driven interfaces are already covered and do not require modification

Issues & Decisions


IssueNotes Decision
1CmNotificationSubscription kafka interfaceRequires determination on coverage 
2To split or not to split

Exact resource path required or partial match is accepted

Exact match example:

Incoming: "CmHandle='a/b/c/d', Resource=''"

Outgoing: "CmHandle='Ch-1', Resource='a/b/c/d'"


Partial match example:

Incoming: "CmHandle='a/b', Resource=''"

Outgoing: "CmHandle='Ch-1', Resource='a/b/c/d'"


Append match example:

Incoming: "CmHandle='a/b', Resource=''e/f"

Outgoing: "CmHandle='Ch-1', Resource='a/b/c/d/e/f'"


3Throw exception for non-exact match

Throw CmHandleNotFound when incoming FDN does not contain perfect resource match


Interfaces


InterfaceRequirementAdditional InformationSign-off
1CPS-E-05


2CPS-E-08.e


3CPS-E-09.e


4CPS-E-10


5CPS-E-11


6CPS-NCMP-I-01


7DMI-I-01Internal - No changes needed

Endpoints

CPS-E-05 


URIRest MethodDescriptionNotes Decision
1

/v1/ch/{cm-handle}/data/ds/{datastore-name}

DELETE

Delete resource data from pass-through running for a given cm handle



2

/v1/ch/{cm-handle}/data/ds/{datastore-name}

GET

Get resource data for given cm handle



3

/v1/ch/{cm-handle}/data/ds/{datastore-name}

PATCH

Patch resource data from pass-through running for the given cm handle



4

/v1/ch/{cm-handle}/data/ds/{datastore-name}

POST

create resource data from pass-through running for given cm handle



5

/v1/ch/{cm-handle}/data/ds/{datastore-name}

PUT

Update resource data from pass-through running for the given cm handle



6

/v1/data

POST

Execute a data operation for group of cm handle ids



7

/v1/ch/{cm-handle}/data/ds/{datastore-name}/query

GET

Query resource data for a given cm handle



8

/v1/ch/{cm-handle}/modules

GET

fetch all module references (name and revision) for a given cm handle



9

/v1/ch/{cm-handle}/modules/definitions

GET

Get module definitions (module name, revision, yang resource) with options to filter on module name and revision



10

/v1/ch/searches

POST

Execute cm handle query search and return a list of cm handle details.



11

/v1/ch/{cm-handle}

GET

Retrieve CM handle details and properties by cm handle id



12

/v1/ch/{cm-handle}/properties

GET

Get CM handle properties by cm handle id



13

/v1/ch/id-searches

POST

Execute cm handle query search and return a list of cm handle ids.



14

/v1/ch/{cm-handle}/data-sync

PUT

Set the data sync enabled flag to true or false for a specified Cm-Handle. This will in turn set the data sync state to UNSYNCHRONIZED and NONE_REQUESTED respectfully.



CPS-E-08.e


URIRest MethodDescription
EndpointEndpoint Type
Notes Decision
1

/ncmp/v1/ch/{cm-handle}/state

GET

Get CM handle state by cm handle id



CPS-E-09.

...

e - New Requirement for Montreal


URIRest MethodDescription
EndpointEndpoint Type
Notes Decision
1




CPS-E-10

...

- Not Yet Implemented


URIRest MethodDescription
EndpointEndpoint Type
Notes Decision
1




CPS-E

...

-11 - Not Yet Implemented


URIRest MethodDescription
EndpointEndpoint Type
Notes Decision
1




CPS-NCMP-I-01 


URIRest MethodDescription
EndpointEndpoint Type
Notes Decision
1

/ncmpInventory/v1/ch

POST

Register a DMI Plugin with any new, updated or removed CM Handles



2

/ncmpInventory/v1/ch/cmHandles

GET

Get all cm handle IDs for a registered DMI plugin



3

/ncmpInventory/v1/ch/searches

POST

Query and get CMHandleIds for additional properties, public properties and registered DMI plugin (DMI plugin, DMI data plugin, DMI model plugin).



DMI-I-01 


URIRest MethodDescription
EndpointEndpoint Type
Notes Decision
1

/dmi/v1/ch/{cmHandle}/modules

POST

Get all modules for given cm handle

Internal - not applicable
2

/dmi/v1/ch/{cmHandle}/moduleResources

POST

Retrieve module resources for one or more modules

Internal - not applicable
3

/dmi/v1/inventory/cmHandles

POST

register given list of cm handles (internal use only)

Internal - not applicable
4

/dmi/v1/ch/{cmHandle}/data/ds/{datastore-name}

POST

Get resource data from passthrough operational or running for a cm handle

Internal - not applicable
5

/dmi/v1/data


POST

Execute a data operation for group of cm handle ids by supplied operation details

Internal - not applicable