1 # ============LICENSE_START=======================================================
2 # Copyright (C) 2021 Nordix Foundation
3 # Modifications Copyright (C) 2021 Pantheon.tech
4 # Modifications Copyright (C) 2021 Bell Canada
5 # ================================================================================
6 # Licensed under the Apache License, Version 2.0 (the "License");
7 # you may not use this file except in compliance with the License.
8 # You may obtain a copy of the License at
10 # http://www.apache.org/licenses/LICENSE-2.0
12 # Unless required by applicable law or agreed to in writing, software
13 # distributed under the License is distributed on an "AS IS" BASIS,
14 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 # See the License for the specific language governing permissions and
16 # limitations under the License.
18 # SPDX-License-Identifier: Apache-2.0
19 # ============LICENSE_END=========================================================
21 nodeByCmHandleAndXpath:
23 description: Get a node with an option to retrieve all the children for a given cm Handle
27 summary: Get a node given a cm Handle and xpath
28 operationId: getNodeByCmHandleAndXpath
30 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
31 - $ref: 'components.yaml#/components/parameters/xpathInQuery'
32 - $ref: 'components.yaml#/components/parameters/includeDescendantsOptionInQuery'
35 $ref: 'components.yaml#/components/responses/Ok'
37 $ref: 'components.yaml#/components/responses/BadRequest'
39 $ref: 'components.yaml#/components/responses/Unauthorized'
41 $ref: 'components.yaml#/components/responses/Forbidden'
43 $ref: 'components.yaml#/components/responses/NotFound'
45 nodesByCmHandleAndCpsPath:
47 description: Query nodes for the given cps path and cm Handle
51 summary: Query data nodes
52 operationId: queryNodesByCmHandleAndCpsPath
54 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
55 - $ref: 'components.yaml#/components/parameters/cpsPathInQuery'
56 - $ref: 'components.yaml#/components/parameters/includeDescendantsOptionInQuery'
59 $ref: 'components.yaml#/components/responses/Ok'
61 $ref: 'components.yaml#/components/responses/BadRequest'
63 $ref: 'components.yaml#/components/responses/Unauthorized'
65 $ref: 'components.yaml#/components/responses/Forbidden'
67 $ref: 'components.yaml#/components/responses/NotFound'
69 nodesByCmHandleAndXpath:
71 description: Create a node with descendants for the given CM Handle; top level or under existing node (requires xpath)
75 summary: Create a node with descendants
76 operationId: createNode
78 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
79 - $ref: 'components.yaml#/components/parameters/xpathInQuery'
88 $ref: 'components.yaml#/components/responses/Created'
90 $ref: 'components.yaml#/components/responses/BadRequest'
92 $ref: 'components.yaml#/components/responses/Unauthorized'
94 $ref: 'components.yaml#/components/responses/Forbidden'
96 $ref: 'components.yaml#/components/responses/NotFound'
99 description: Update node leaves for the given cps path and cm Handle
103 summary: Update node leaves
104 operationId: updateNodeLeaves
106 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
107 - $ref: 'components.yaml#/components/parameters/xpathInQuery'
116 $ref: 'components.yaml#/components/responses/Ok'
118 $ref: 'components.yaml#/components/responses/BadRequest'
120 $ref: 'components.yaml#/components/responses/Unauthorized'
122 $ref: 'components.yaml#/components/responses/Forbidden'
124 $ref: 'components.yaml#/components/responses/NotFound'
127 description: Replace a node with descendants for the given cps path and cm Handle
131 summary: Replace a node with descendants
132 operationId: replaceNode
134 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
135 - $ref: 'components.yaml#/components/parameters/xpathInQuery'
144 $ref: 'components.yaml#/components/responses/Ok'
146 $ref: 'components.yaml#/components/responses/BadRequest'
148 $ref: 'components.yaml#/components/responses/Unauthorized'
150 $ref: 'components.yaml#/components/responses/Forbidden'
152 $ref: 'components.yaml#/components/responses/NotFound'
154 listNodeByCmHandleAndXpath:
156 description: Add one or more list-node child elements under existing node for the given CM Handle
160 summary: Add list-node child element(s)
161 operationId: addListNodeElements
163 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
164 - $ref: 'components.yaml#/components/parameters/requiredXpathInQuery'
173 $ref: 'components.yaml#/components/responses/Created'
175 $ref: 'components.yaml#/components/responses/BadRequest'
177 $ref: 'components.yaml#/components/responses/Unauthorized'
179 $ref: 'components.yaml#/components/responses/Forbidden'
181 $ref: 'components.yaml#/components/responses/NotFound'
183 getResourceDataForPassthroughOperational:
187 summary: Get resource data from pass-through operational for cm handle
188 description: Get resource data from pass-through operational for given cm handle
189 operationId: getResourceDataOperationalForCmHandle
191 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
192 - $ref: 'components.yaml#/components/parameters/resourceIdentifierInQuery'
193 - $ref: 'components.yaml#/components/parameters/acceptParamInHeader'
194 - $ref: 'components.yaml#/components/parameters/optionsParamInQuery'
197 $ref: 'components.yaml#/components/responses/Ok'
199 $ref: 'components.yaml#/components/responses/BadRequest'
201 $ref: 'components.yaml#/components/responses/Unauthorized'
203 $ref: 'components.yaml#/components/responses/Forbidden'
205 $ref: 'components.yaml#/components/responses/NotFound'
207 resourceDataForPassthroughRunning:
211 summary: Get resource data from pass-through running for cm handle
212 description: Get resource data from pass-through running for given cm handle
213 operationId: getResourceDataRunningForCmHandle
215 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
216 - $ref: 'components.yaml#/components/parameters/resourceIdentifierInQuery'
217 - $ref: 'components.yaml#/components/parameters/acceptParamInHeader'
218 - $ref: 'components.yaml#/components/parameters/optionsParamInQuery'
221 $ref: 'components.yaml#/components/responses/Ok'
223 $ref: 'components.yaml#/components/responses/BadRequest'
225 $ref: 'components.yaml#/components/responses/Unauthorized'
227 $ref: 'components.yaml#/components/responses/Forbidden'
229 $ref: 'components.yaml#/components/responses/NotFound'
233 summary: create resource data from pass-through running for cm handle
234 description: create resource data from pass-through running for given cm handle
235 operationId: createResourceDataRunningForCmHandle
237 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
238 - $ref: 'components.yaml#/components/parameters/resourceIdentifierInQuery'
239 - $ref: 'components.yaml#/components/parameters/contentParamInHeader'
246 application/yang-data+json:
251 $ref: 'components.yaml#/components/responses/Created'
253 $ref: 'components.yaml#/components/responses/BadRequest'
255 $ref: 'components.yaml#/components/responses/Unauthorized'
257 $ref: 'components.yaml#/components/responses/Forbidden'
259 $ref: 'components.yaml#/components/responses/NotFound'
261 fetchModuleReferencesByCmHandle:
263 description: fetch all module references (name and revision) for a given cm handle
266 summary: Fetch all module references (name and revision) for a given cm handle
267 operationId: getModuleReferencesByCmHandle
269 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
277 example: [{"moduleName": "nc-notifications", "revision": "2008-07-14"}]
278 $ref: 'components.yaml#/components/responses/Ok'
280 $ref: 'components.yaml#/components/responses/BadRequest'
282 $ref: 'components.yaml#/components/responses/Unauthorized'
284 $ref: 'components.yaml#/components/responses/Forbidden'
286 $ref: 'components.yaml#/components/responses/NotFound'