1 # ============LICENSE_START=======================================================
2 # Copyright (C) 2021 Nordix Foundation
3 # Modifications Copyright (C) 2021 Pantheon.tech
4 # ================================================================================
5 # Licensed under the Apache License, Version 2.0 (the "License");
6 # you may not use this file except in compliance with the License.
7 # You may obtain a copy of the License at
9 # http://www.apache.org/licenses/LICENSE-2.0
11 # Unless required by applicable law or agreed to in writing, software
12 # distributed under the License is distributed on an "AS IS" BASIS,
13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 # See the License for the specific language governing permissions and
15 # limitations under the License.
17 # SPDX-License-Identifier: Apache-2.0
18 # ============LICENSE_END=========================================================
20 nodeByCmHandleAndXpath:
22 description: Get a node with an option to retrieve all the children for a given cm Handle
25 summary: Get a node given a cm Handle and xpath
26 operationId: getNodeByCmHandleAndXpath
28 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
29 - $ref: 'components.yaml#/components/parameters/xpathInQuery'
30 - $ref: 'components.yaml#/components/parameters/includeDescendantsOptionInQuery'
33 $ref: 'components.yaml#/components/responses/Ok'
35 $ref: 'components.yaml#/components/responses/BadRequest'
37 $ref: 'components.yaml#/components/responses/Unauthorized'
39 $ref: 'components.yaml#/components/responses/Forbidden'
41 $ref: 'components.yaml#/components/responses/NotFound'
43 nodesByCmHandleAndCpsPath:
45 description: Query nodes for the given cps path and cm Handle
48 summary: Query data nodes
49 operationId: queryNodesByCmHandleAndCpsPath
51 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
52 - $ref: 'components.yaml#/components/parameters/cpsPathInQuery'
53 - $ref: 'components.yaml#/components/parameters/includeDescendantsOptionInQuery'
56 $ref: 'components.yaml#/components/responses/Ok'
58 $ref: 'components.yaml#/components/responses/BadRequest'
60 $ref: 'components.yaml#/components/responses/Unauthorized'
62 $ref: 'components.yaml#/components/responses/Forbidden'
64 $ref: 'components.yaml#/components/responses/NotFound'
66 nodesByCmHandleAndXpath:
68 description: Create a node with descendants for the given CM Handle; top level or under existing node (requires xpath)
71 summary: Create a node with descendants
72 operationId: createNode
74 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
75 - $ref: 'components.yaml#/components/parameters/xpathInQuery'
84 $ref: 'components.yaml#/components/responses/Created'
86 $ref: 'components.yaml#/components/responses/BadRequest'
88 $ref: 'components.yaml#/components/responses/Unauthorized'
90 $ref: 'components.yaml#/components/responses/Forbidden'
92 $ref: 'components.yaml#/components/responses/NotFound'
95 description: Update node leaves for the given cps path and cm Handle
98 summary: Update node leaves
99 operationId: updateNodeLeaves
101 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
102 - $ref: 'components.yaml#/components/parameters/xpathInQuery'
111 $ref: 'components.yaml#/components/responses/Ok'
113 $ref: 'components.yaml#/components/responses/BadRequest'
115 $ref: 'components.yaml#/components/responses/Unauthorized'
117 $ref: 'components.yaml#/components/responses/Forbidden'
119 $ref: 'components.yaml#/components/responses/NotFound'
122 description: Replace a node with descendants for the given cps path and cm Handle
125 summary: Replace a node with descendants
126 operationId: replaceNode
128 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
129 - $ref: 'components.yaml#/components/parameters/xpathInQuery'
138 $ref: 'components.yaml#/components/responses/Ok'
140 $ref: 'components.yaml#/components/responses/BadRequest'
142 $ref: 'components.yaml#/components/responses/Unauthorized'
144 $ref: 'components.yaml#/components/responses/Forbidden'
146 $ref: 'components.yaml#/components/responses/NotFound'
148 listNodeByCmHandleAndXpath:
150 description: Add one or more list-node child elements under existing node for the given CM Handle
153 summary: Add list-node child element(s)
154 operationId: addListNodeElements
156 - $ref: 'components.yaml#/components/parameters/cmHandleInPath'
157 - $ref: 'components.yaml#/components/parameters/requiredXpathInQuery'
166 $ref: 'components.yaml#/components/responses/Created'
168 $ref: 'components.yaml#/components/responses/BadRequest'
170 $ref: 'components.yaml#/components/responses/Unauthorized'
172 $ref: 'components.yaml#/components/responses/Forbidden'
174 $ref: 'components.yaml#/components/responses/NotFound'