{"type":"doc","content":[{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"6e93ae90-918d-42dd-b3c9-6cb4b37573e1"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"heading","attrs":{"level":1},"content":[{"text":"References","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://lf-onap.atlassian.net/browse/CPS-390"}}]},{"type":"paragraph","content":[{"text":"RESTful API Design Specification","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/spaces/DW/pages/16231207"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Issues and Decisions","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","isNumberColumnEnabled":true},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[409.62]},"content":[{"type":"paragraph","content":[{"text":"Issue","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[416.52]},"content":[{"type":"paragraph","content":[{"text":"Notes","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[424.41]},"content":[{"type":"paragraph","content":[{"text":"Decision","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#ddfade","rowspan":1,"colwidth":[409.62]},"content":[{"type":"paragraph","content":[{"text":"How will hostname and port be provided when dmiPlugin register itself and its list of cmHandles with NCMP","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#ddfade","rowspan":1,"colwidth":[416.52]},"content":[{"type":"paragraph","content":[{"text":"The team thinks that the information should instead be provided in the form of a ‘host-name’ and a ‘port’ (there was some debate on service-name v. host-name but it was settled on host-name)","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"e.g. \"dmiPlugin\" : { , }","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Where the host-name is unique. (the DB might assign an internal unique ID for each entry but that is just for indexing and x-referencing in a relation DB and this ID is not to be used/ exposed externally)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#ddfade","rowspan":1,"colwidth":[424.41]},"content":[{"type":"paragraph","content":[{"text":"Instead of using ‘host-names’ and ‘ports’ parameters between java applications when in the cloud all we need is ‘service-names’ . The mapping of service-names to hosts and ports is done as part of the cloud configuration, in our case Kubernetes. And these are dynamic! The client application can then use a simple dns-lookup to connect to an instance of the service.","type":"text"}]},{"type":"paragraph","content":[{"text":"Using service names also allows any plugin to use implement scaling as they see fit e.g. partitioning","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"For the ONAP DMI Plugin which initial have only 1 instance we can simply hard-code the service-name and us the same name in the Kubernetes configuration e.g. “onap.cps.dmiPlugin\"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#ddfade","rowspan":1,"colwidth":[409.62]},"content":[{"type":"paragraph","content":[{"text":"Additional information in request body duplicates cmHandleId this is redundant information","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#ddfade","rowspan":1,"colwidth":[416.52]},"content":[{"type":"paragraph","content":[{"text":"Suggested to remove from request body to avoid possible error scenarios.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#ddfade","rowspan":1,"colwidth":[424.41]},"content":[{"type":"paragraph","content":[{"text":"Only the one with the additionalInformation is needed and remove body","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#ddfade","rowspan":1,"colwidth":[409.62]},"content":[{"type":"paragraph","content":[{"text":"No need for Sync method, this is basic standard read operation at the root level for that cmHandle","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#ddfade","rowspan":1,"colwidth":[416.52]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#ddfade","rowspan":1,"colwidth":[424.41]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#ddfade","rowspan":1,"colwidth":[409.62]},"content":[{"type":"paragraph","content":[{"text":"Use include 'location' property when request yang-module sources","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#ddfade","rowspan":1,"colwidth":[416.52]},"content":[{"type":"paragraph","content":[{"text":"Suggestion: do include it in the request but allow dmiPlugin to decide to use it or now. Location (this leaf is called schema in older RFC7895) is not mandatory to support in YANG library and nodes may not include it. Another alternative presumably used also by ODL itself is the RPC. The key difference is that the YANG module definition is sent directly over the NETCONF channel, not requiring separate file servers and clients. So this is maybe one more reason that the ONAP DMI plugin currently doesn’t need the location attribute.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#ddfade","rowspan":1,"colwidth":[424.41]},"content":[{"type":"paragraph","content":[{"text":"Location is not needed for any plugin and could only lead to ambiguity therefore will NOT be included in this request","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[409.62]},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[416.52]},"content":[{"type":"paragraph","content":[{"text":"Inconsistent use of \"Operation\" and/or HTTP Methods to distinguish write operations","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[424.41]},"content":[{"type":"paragraph","content":[{"text":"Currently this page proposes to use \"Operation=update\" request body parameter for restconf \"Replace\" and \"Patch\" operations and use the HTTP (RESTFul) operation to distinguish between them. It also proposes to use PUT HTTP for Read and Delete operations ","type":"text"},{"type":"emoji","attrs":{"id":"1f641","text":"🙁","shortName":":slight_frown:"}},{"text":" Basically a very confusing an unintuitive use of HTTP operations to distinguish ambiguous operations that instead easily could be defined by just using the 'operation' field in the request body.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[0.0]},"content":[{"type":"paragraph","content":[{"text":"Proposal Toine:","type":"text","marks":[{"type":"strong"}]},{"text":" For Consistent (restful) design I would suggest to think as the operation to DMI-Plugin (always with body) as \"creating a new order to do something\" toward DMI-Plugin. Ie always a HTTP POST (or PUT?) operation. The \"operation \" in the body can simple be extended to include both \"update\" and \"patch\" as required. If the 'operation' is NOT supplied \"read\" wil be assumed as the default operation","type":"text"}]},{"type":"paragraph","content":[{"text":"See also ","type":"text"},{"text":"CPS-NCMP - DMI - SDNC Request and Response Mapping","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/spaces/DW/pages/16484061"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Proposal agreed by stakeholders in meeting ","type":"text"},{"type":"date","attrs":{"timestamp":"1636416000000"}},{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Only 'POST' method needs to be supported","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"use term 'Update' instead of 'replace'","type":"text"}]}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"DMI URI","type":"text"}]},{"type":"paragraph","content":[{"text":"Below table shows the proposed interface, actual implementation might deviate from this but can be accessed from","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gerrit Source","type":"text","marks":[{"type":"link","attrs":{"href":"https://gerrit.onap.org/r/gitweb?p=cps/ncmp-dmi-plugin.git;a=tree;f=docs/openapi;h=e645d54772dc3fdb28b67991959dd5ecf96be499;hb=refs/heads/master"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Read-the-docs: ","type":"text"},{"text":"https://docs.onap.org/projects/onap-cps-ncmp-dmi-plugin/en/latest/design.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.onap.org/projects/onap-cps-ncmp-dmi-plugin/en/latest/design.html"}}]}]}]}]},{"type":"paragraph","content":[{"text":"DMI URI format to follow below pattern","type":"text"}]},{"type":"paragraph","content":[{"text":"dmi//ch///ds//[rp:]?","type":"text"}]},{"type":"table","attrs":{"layout":"full-width"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[595.0]},"content":[{"type":"paragraph","content":[{"text":"URI","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Mandatory or Optional","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[509.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[595.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"mandatory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[509.0]},"content":[{"type":"paragraph","content":[{"text":"the HTTP method","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[595.0]},"content":[{"type":"paragraph","content":[{"text":"dmi","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"mandatory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[509.0]},"content":[{"type":"paragraph","content":[{"text":"the dmi root resource","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[595.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"mandatory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[509.0]},"content":[{"type":"paragraph","content":[{"text":"version of the dmi interface is the target resource URI is the query parameter list","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[595.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"mandatory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[509.0]},"content":[{"type":"paragraph","content":[{"text":"unique (string) identifier of a yang tree instance.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[595.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"mandatory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[509.0]},"content":[{"type":"paragraph","content":[{"text":"yang data, rpc operation or a (non-modeled) dmi action","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[595.0]},"content":[{"type":"paragraph","content":[{"text":"{datastore}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"mandatory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[509.0]},"content":[{"type":"paragraph","content":[{"text":"mandatory datastore","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[595.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[509.0]},"content":[{"type":"paragraph","content":[{"text":"the path expression identifying the resource that is","type":"text"},{"type":"hardBreak"},{"text":"being accessed by the operation. If this field is not","type":"text"},{"type":"hardBreak"},{"text":"present, then the target resource is the API itself.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[595.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[509.0]},"content":[{"type":"paragraph","content":[{"text":"the set of parameters associated with the RESTCONF message;","type":"text"},{"type":"hardBreak"},{"text":"see Section 3.4 of [RFC3986]. RESTCONF parameters have ","type":"text"},{"type":"hardBreak"},{"text":"the familiar form of \"name=value\" pairs. Most query parameters are","type":"text"},{"type":"hardBreak"},{"text":"optional to implement by the server and optional to use by the client. Each optional query parameter is identified by a URI","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"NCPS-NCMP - DMI Plugin Write Request Flow","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"CPS-NCMP - DMI - SDNC Request and Response Mapping","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/spaces/DW/pages/16484061"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Datastore","type":"text"}]},{"type":"paragraph","content":[{"text":"If the cmhandle metadata indicates that data is not synched in CPS then the request is forwarded to the dmiPlugin","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"RESTCONF/NETCONF relationship","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":34.0},"content":[{"type":"media","attrs":{"width":439,"id":"4f0f036e-0f8b-46f3-81a9-f5a756f3270d","collection":"contentId-16476103","type":"file","height":247}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"REST Data API","type":"text"}]},{"type":"paragraph","content":[{"text":"The DMI APIs for data access are similar to corresponding NCMP APIs. The following list is a summary of the main differences:","type":"text"},{"type":"hardBreak"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" The URI prefix is /dmi instead of /ncmp.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For non-passthrough datastores, the resource path will be converted from cpsPath to RESTConfPath","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The body for each request will contain additional information and any data provided on the NCMP interface (write operations) will be embedded in a larger JSON structure as described in example below.","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Since all requests will have a message body, in some cases the HTTP method will be different to allow passing data. Thus POST can be used, the actual operation will be read from the body.","type":"text"}]}]}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"atlassian-macro-output-type":{"value":"INLINE"}},"macroMetadata":{"macroId":{"value":"98d114a1-29aa-48e4-8548-5f991fc99b64"},"schemaVersion":{"value":"1"},"title":"Excerpt"}}},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Request Format for Data Access","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"request body","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"{\n “operation”: “”, // Valid operations are: “create”, “read”, “update”, “patch” and “delete”.\n \n \"dataType\": \"\", // e.g. \"application/yang.data\"\n\n “data”: { // Embedded data as a String.\n // required for create and update operations. Optional filter-data for read-operations\n },\n\n “cmHandleProperties”: { // Additional properties for CM handle previously added by DMI plugin and stored in NCMP.\n \n }\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"expand","attrs":{"title":"API details"},"content":[{"type":"paragraph","content":[{"text":"Below table shows the proposed interface, actual implementation might deviate from this but can be accessed from","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gerrit Source","type":"text","marks":[{"type":"link","attrs":{"href":"https://gerrit.onap.org/r/gitweb?p=cps/ncmp-dmi-plugin.git;a=tree;f=docs/openapi;h=e645d54772dc3fdb28b67991959dd5ecf96be499;hb=refs/heads/master"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Read-the-docs: ","type":"text"},{"text":"https://docs.onap.org/projects/onap-cps-ncmp-dmi-plugin/en/latest/design.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.onap.org/projects/onap-cps-ncmp-dmi-plugin/en/latest/design.html"}}]}]}]}]},{"type":"table","attrs":{"layout":"full-width"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[28.02]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[412.58]},"content":[{"type":"paragraph","content":[{"text":"Usecase","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[165.21]},"content":[{"type":"paragraph","content":[{"text":"REST Method","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.62]},"content":[{"type":"paragraph","content":[{"text":"URI","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[28.02]},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[412.58]},"content":[{"type":"paragraph","content":[{"text":"Add a data resource for a cmHandle","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[165.21]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[423.62]},"content":[{"type":"paragraph","content":[{"text":"{dmiRoot}/dmi/v1/ch//data/ds/ncmp-datastore:running/{parentDataResourceIdentifier}","type":"text"}]},{"type":"paragraph","content":[{"text":"{","type":"text"},{"type":"hardBreak"},{"text":"","type":"text"},{"type":"hardBreak"},{"text":"}","type":"text"}]},{"type":"paragraph","content":[{"text":"Content-Type: application/json","type":"text"}]},{"type":"paragraph","content":[{"text":"\"data\" payload : yang-data+json","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[28.02]},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[412.58]},"content":[{"type":"paragraph","content":[{"text":"Delete a data resource for a cmHandle","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[165.21]},"content":[{"type":"paragraph","content":[{"text":"PUT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.62]},"content":[{"type":"paragraph","content":[{"text":"{dmiRoot}/dmi/v1/ch//data/ds/ncmp-datastore:running/{resourceIdentifier}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[28.02]},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[412.58]},"content":[{"type":"paragraph","content":[{"text":"Patch a data resource for a cmHandle","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[165.21]},"content":[{"type":"paragraph","content":[{"text":"PATCH","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.62]},"content":[{"type":"paragraph","content":[{"text":"{dmiRoot}/dmi/v1/ch//data/ds/ncmp-datastore:running/{resourceIdentifier}","type":"text"}]},{"type":"paragraph","content":[{"text":"{","type":"text"},{"type":"hardBreak"},{"text":"","type":"text"},{"type":"hardBreak"},{"text":"}","type":"text"}]},{"type":"paragraph","content":[{"text":"Content-Type: application/json","type":"text"}]},{"type":"paragraph","content":[{"text":"\"data\" payload : yang-data+json","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[28.02]},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[412.58]},"content":[{"type":"paragraph","content":[{"text":"Patch multiple child resources for a single cmHandle","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[165.21]},"content":[{"type":"paragraph","content":[{"text":"PATCH","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.62]},"content":[{"type":"paragraph","content":[{"text":"{dmiRoot}/dmi/v1/ch//data/ds//{resourceIdentifier}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Content-Type: application/json","type":"text"}]},{"type":"paragraph","content":[{"text":"\"data\" payload : yang-patch+json","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[28.02]},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[412.58]},"content":[{"type":"paragraph","content":[{"text":"Execute a yang action on a cmhandle instance","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[165.21]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.62]},"content":[{"type":"paragraph","content":[{"text":"{dmiRoot}/dmi/v1/ch//data/ds/ncmp-datastore:operational/{resourceIdentifier}/{action}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"input: {","type":"text"},{"type":"hardBreak"},{"text":" \"param1Name\" :\"param1Value”,","type":"text"},{"type":"hardBreak"},{"text":" \"param2Name\" : \"param2Value”","type":"text"}]},{"type":"paragraph","content":[{"text":"}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Note : If the \"action\" statement has no \"input\" section, the request message MUST NOT include a message-body","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[28.02]},"content":[{"type":"paragraph","content":[{"text":"6","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[412.58]},"content":[{"type":"paragraph","content":[{"text":"Execute an rpc operation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[165.21]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.62]},"content":[{"type":"paragraph","content":[{"text":"{dmiRoot}/dmi/v1/operations/ch//ds/ncmp-datastore:operational/ {module-name}:{action}","type":"text"}]},{"type":"paragraph","content":[{"text":"{ input: {","type":"text"},{"type":"hardBreak"},{"text":" \"param1Name\" : \"param1Value”,","type":"text"},{"type":"hardBreak"},{"text":" \"param2Name\" : \"param2Value”","type":"text"},{"type":"hardBreak"},{"text":"} }","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: If there is no \"input\" section, the request MUST NOT include a message-body","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[28.02]},"content":[{"type":"paragraph","content":[{"text":"7","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[412.58]},"content":[{"type":"paragraph","content":[{"text":"Read a filtered set of data under a data resource for a cmHandle","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"bdc50b1d-1d39-4a08-9819-866d5cae8bfa"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[165.21]},"content":[{"type":"paragraph","content":[{"text":"PUT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.62]},"content":[{"type":"paragraph","content":[{"text":"{dmiroot}/dmi/v1/ch//data/ds/ncmp-datastore:operational/{resourceIdentifier}?fields={fields-expression}","type":"text"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"nested-table","text":"","parameters":{"cxhtml":"

Option	Description
fields	Request a subset of the target resource contents

Option	Description
fields	Request a subset of the target resource contents

Option	Description
depth	Request limited sub-tree depth in the reply content If '1' then only immediate resource is retrieved If '2' then resource plus next level resources are retrieved

","nestedContent":{"type":"doc","content":[{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Option","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"depth","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Request limited sub-tree depth in ","type":"text"},{"type":"hardBreak"},{"text":"the reply content","type":"text"},{"type":"hardBreak"},{"text":"If '1' then only immediate resource ","type":"text"},{"type":"hardBreak"},{"text":"is retrieved","type":"text"},{"type":"hardBreak"},{"text":"If '2' then resource plus next level ","type":"text"},{"type":"hardBreak"},{"text":"resources are retrieved","type":"text"}]}]}]}]}],"version":1},"adf":"{\"type\":\"doc\",\"content\":[{\"type\":\"table\",\"content\":[{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableHeader\",\"attrs\":{\"colspan\":1,\"rowspan\":1},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"Option\",\"type\":\"text\"}]}]},{\"type\":\"tableHeader\",\"attrs\":{\"colspan\":1,\"rowspan\":1},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"Description\",\"type\":\"text\"}]}]}]},{\"type\":\"tableRow\",\"content\":[{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"depth\",\"type\":\"text\"}]}]},{\"type\":\"tableCell\",\"attrs\":{\"colspan\":1,\"rowspan\":1},\"content\":[{\"type\":\"paragraph\",\"content\":[{\"text\":\"Request limited sub-tree depth in \",\"type\":\"text\"},{\"type\":\"hardBreak\"},{\"text\":\"the reply content\",\"type\":\"text\"},{\"type\":\"hardBreak\"},{\"text\":\"If '1' then only immediate resource \",\"type\":\"text\"},{\"type\":\"hardBreak\"},{\"text\":\"is retrieved\",\"type\":\"text\"},{\"type\":\"hardBreak\"},{\"text\":\"If '2' then resource plus next level \",\"type\":\"text\"},{\"type\":\"hardBreak\"},{\"text\":\"resources are retrieved\",\"type\":\"text\"}]}]}]}]}],\"version\":1}","reason":"A table in a table cell can't be created or edited in the new editor."}}},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[28.02]},"content":[{"type":"paragraph","content":[{"text":"11","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[412.58]},"content":[{"type":"paragraph","content":[{"text":"Replace data for a CMHandle","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[165.21]},"content":[{"type":"paragraph","content":[{"text":"PUT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.62]},"content":[{"type":"paragraph","content":[{"text":"{dmiRoot}/dmi/v1/ch//data/ds/ncmp-datastore:running/{resourceIdentifier}","type":"text"}]},{"type":"paragraph","content":[{"text":"{data : {","type":"text"}]},{"type":"paragraph","content":[{"text":" .... the complete tree config to be replaced","type":"text"}]},{"type":"paragraph","content":[{"text":" }}","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"DMI Inventory, Model & Data Sync API","type":"text"}]},{"type":"paragraph","content":[{"type":"mediaInline","attrs":{"id":"f62e5ebf-3ba3-4df8-bb12-4dbce7b16ef5","collection":"contentId-16476103"}},{"text":" This presentation illustrates the API methods #1, #3 and #4 detailed below","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"expand","attrs":{"title":"API Details"},"content":[{"type":"paragraph","content":[{"text":"Below table shows the proposed interface, actual implementation might deviate from this but can be accessed from","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gerrit Source","type":"text","marks":[{"type":"link","attrs":{"href":"https://gerrit.onap.org/r/gitweb?p=cps/ncmp-dmi-plugin.git;a=tree;f=docs/openapi;h=e645d54772dc3fdb28b67991959dd5ecf96be499;hb=refs/heads/master"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Read-the-docs: ","type":"text"},{"text":"https://docs.onap.org/projects/onap-cps-ncmp-dmi-plugin/en/latest/design.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.onap.org/projects/onap-cps-ncmp-dmi-plugin/en/latest/design.html"}}]}]}]}]},{"type":"paragraph","content":[{"text":"*For response output, where applicable the yang-library format and conventions are used 'as is' or extended","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"061787a9-41a3-4ebf-bc84-246ec778cf6a"}}]}]},{"type":"table","attrs":{"layout":"full-width","isNumberColumnEnabled":true},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.66]},"content":[{"type":"paragraph","content":[{"text":"Use Case","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[146.11]},"content":[{"type":"paragraph","content":[{"text":"Rest Method","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.89]},"content":[{"type":"paragraph","content":[{"text":"URI","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[595.75]},"content":[{"type":"paragraph","content":[{"text":"Example*","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[183.66]},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[146.11]},"content":[{"type":"paragraph","content":[{"text":"Get module set for a cmhandle","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"801089c3-e960-431e-bab2-ad8a4066d2bd"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[162.89]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"c175432a-2ae7-439e-8f5b-edcea9a85802"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[595.75]},"content":[{"type":"paragraph","content":[{"text":"{dmiRoot}/dmi/v1/ch/","type":"text"},{"text":"cmhandle-001","type":"text","marks":[{"type":"textColor","attrs":{"color":"#067d17"}}]},{"text":"/","type":"text"},{"text":"modules","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"46e1583b-7094-42d7-93f5-451b0d780ad5"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[0.0]},"content":[{"type":"paragraph","content":[{"text":"Header","type":"text","marks":[{"type":"strong"}]},{"text":" :","type":"text"},{"type":"hardBreak"},{"text":"Content-Type","type":"text","marks":[{"type":"textColor","attrs":{"color":"#0033b3"}}]},{"text":": application/json","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Request Body","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"{\n \"operation\": \"read\",\n \"cmHandleProperties \": {\n \"subSystemId\": \"system-001\"\n }\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Response Body","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"Response: \n \"schemas\": [\n {\n \"moduleName\": \"example-identifier\",\n \"revision\": \"example-version\",\n \"namespace\": \"example-namespace\"\n },\n\t\t\t\t\t{\n\t\t\t\t\t\t...\n\t\t\t\t\t}\n ]\n }","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[183.66]},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[146.11]},"content":[{"type":"paragraph","content":[{"text":"Get yang module source for a list of modules","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[162.89]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[595.75]},"content":[{"type":"paragraph","content":[{"text":"{dmiRoot}/dmi/v1/ch//moduleResources","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"DMI Plugin will make multiple requests to xNF and combine the result in a list","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e3fcef","rowspan":1,"colwidth":[0.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Request Body","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"{\n \"operation\": \"read\",\n\t\"dataType\": \"application/json\",\n \"data\": {\n \"modules\": [\n {\n \"name\": \"pnf-sw-upgrade\",\n \"revision\": \"2019-12-03\"\n }\n ]\n },\n \"cmHandleProperties\": {\n \"subSystemId\": \"system-001\"\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Response: a list yang module references and source for each","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Response Body","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"[ {\n\"name\" : \"pnf-sw-upgrade\",\n\"revision\" : \"2019-12-03\",\n\"yang-source\": \"some-source\", {...} ]","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"GET Request with body","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The HTTP libraries of certain languages (notably JavaScript) don’t allow GET requests to have a request body. In fact, some users are surprised that GET requests are ever allowed to have a body.","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The truth is that RFC 7231—the RFC that deals with HTTP semantics and content—does not define what should happen to a GET request with a body! As a result, some HTTP servers allow it, and some—especially caching proxies—don’t.","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The authors of Elasticsearch prefer using GET for a search request because they feel that it describes the action—retrieving information—better than the POST verb. However, because GET with a request body is not universally supported, the search API also accepts POST requests: }","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The same rule applies to any other GET API that requires a request body.","type":"text"},{"type":"hardBreak"},{"text":"See Elasticsearch details here for more info","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"yang-patch operations (see rfc8072)","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"\"create\", \"delete\", \"insert\", \"merge\", \"move\", \"replace\", and \"remove\"","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"YANG Data Structure Extensions","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"https://tools.ietf.org/html/rfc8791","type":"text","marks":[{"type":"link","attrs":{"href":"https://tools.ietf.org/html/rfc8791"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"References","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow principles/patterns of RESTCONF RFC-8040 ","type":"text"},{"text":"https://datatracker.ietf.org/doc/html/rfc8040","type":"text","marks":[{"type":"link","attrs":{"href":"https://datatracker.ietf.org/doc/html/rfc8040"}}]},{"type":"hardBreak"},{"text":"Follow principles/patterns of yang-patch RFC-8072 ","type":"text"},{"text":"https://datatracker.ietf.org/doc/html/rfc8040","type":"text","marks":[{"type":"link","attrs":{"href":"https://datatracker.ietf.org/doc/html/rfc8040"}}]},{"type":"hardBreak"},{"text":"Follow principles/patterns of RESTCONF NMDA RFC-8527 ","type":"text"},{"text":"https://datatracker.ietf.org/doc/html/rfc8527","type":"text","marks":[{"type":"link","attrs":{"href":"https://datatracker.ietf.org/doc/html/rfc8527"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported