summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorRitu Sood <ritu.sood@intel.com>2020-06-23 14:04:57 -0700
committerRitu Sood <ritu.sood@intel.com>2020-06-29 11:40:24 -0700
commitae89c3034173ed2d5a86510c0e16ac50c7f3c441 (patch)
tree168f853bc6e64f121d3e4c1c5cf4a22f436edf70 /docs
parent7165b8294a820e00335067439086e792581e71a4 (diff)
OpenAPI definition for API's
Creates openAPI document for K8s v2 API's. Issue-ID: MULTICLOUD-1096 Signed-off-by: Ritu Sood <ritu.sood@intel.com> Change-Id: Id9210ae5604d1f8080f890723785cc9d05a99aea
Diffstat (limited to 'docs')
-rw-r--r--docs/controllers.yaml161
-rw-r--r--docs/emco_apis.yaml3147
2 files changed, 3147 insertions, 161 deletions
diff --git a/docs/controllers.yaml b/docs/controllers.yaml
deleted file mode 100644
index 9d266846..00000000
--- a/docs/controllers.yaml
+++ /dev/null
@@ -1,161 +0,0 @@
-# Copyright 2020 Intel Corporation.
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-# http://www.apache.org/licenses/LICENSE-2.0
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-openapi: 3.0.1
-info:
- title: ONAP4K8S Orchestrator Controller Register API
- description: 'This is the Orchestrator Controller gRPC Register API. Find out more about the Orchestrator at: https://wiki.onap.org/display/DW/Multi+Cluster+Application+Scheduler'
- contact:
- name: Marcus Williams
- email: marcus.williams@intel.com
- license:
- name: Apache 2.0
- url: http://www.apache.org/licenses/LICENSE-2.0.html
- version: 0.0.1
-externalDocs:
- description: ONAP4K8S Orchestrator Controller Register API
- url: 'https://wiki.onap.org/display/DW/V2+API+Specification#V2APISpecification-OrchestratorControllerRegistrationAPI'
-servers:
-- url: http://127.0.0.1:9015
-tags:
-- name: controllers
-
-paths:
- /v2/controllers:
- post:
- tags:
- - controllers
- summary: Add a new controller to the orchestrator
- operationId: addController
- requestBody:
- description: Describe new controller to add to the orchestrator
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/Controller'
- required: true
- responses:
- 405:
- description: Invalid input
- content: {}
- security:
- - OAuth2: []
- - OpenId: []
- - BasicHTTP: []
- x-codegen-request-body-name: body
- put:
- tags:
- - controllers
- summary: Add a new controller to the orchestrator
- operationId: putController
- requestBody:
- description: Describe new controller to add to the orchestrator
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/Controller'
- required: true
- responses:
- 405:
- description: Validation exception
- content: {}
- security:
- - OAuth2: []
- - OpenId: []
- - BasicHTTP: []
- x-codegen-request-body-name: body
- /v2/controllers/{controller-name}:
- get:
- tags:
- - controllers
- summary: Find controller by name
- description: Returns a controller
- operationId: getController
- parameters:
- - name: controller-name
- in: path
- description: Name of controller
- required: true
- schema:
- type: string
- responses:
- 200:
- description: successful operation
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/Controller'
- 400:
- description: Invalid controller-name supplied
- content: {}
- 404:
- description: Controller not found
- content: {}
- security:
- - OAuth2: []
- - OpenId: []
- - BasicHTTP: []
- delete:
- tags:
- - controllers
- summary: Deletes a controller
- operationId: deleteController
- parameters:
- - name: controller-name
- in: path
- description: service name
- required: true
- schema:
- type: string
- responses:
- 400:
- description: Invalid controller name supplied
- content: {}
- 404:
- description: Controller not found
- content: {}
- security:
- - OAuth2: []
- - OpenId: []
- - BasicHTTP: []
-components:
- schemas:
- Controller:
- type: object
- required:
- - name
- - host
- - port
- properties:
- name:
- type: string
- host:
- type: string
- port:
- type: integer
- format: int64
- example:
- name: HPA-Placement-Controller
- host: 10.7.100.4
- port: 8800
- securitySchemes:
- OAuth2:
- type: oauth2
- flows:
- authorizationCode:
- authorizationUrl: /oauth/authorize
- tokenUrl: /oauth/token
- OpenId:
- type: openIdConnect
- openIdConnectUrl: https://example.com/.well-known/openid-configuration
- BasicHTTP:
- type: http
- scheme: basic
diff --git a/docs/emco_apis.yaml b/docs/emco_apis.yaml
new file mode 100644
index 00000000..b44553f7
--- /dev/null
+++ b/docs/emco_apis.yaml
@@ -0,0 +1,3147 @@
+
+openapi: 3.0.2
+info:
+ version: '2.0.0'
+
+ title: EMCO
+
+ license:
+ name: Apache 2.0
+ url: 'http://www.apache.org/licenses/LICENSE-2.0.html'
+ x-logo:
+ url: 'https://redocly.github.io/openapi-template/logo.png'
+
+ description: |
+ EMCO - Edge Multi Cluster Orchestrator
+ # Introduction
+ Application Orchestration - For applications and services delivered across multiple administrative infrastructures
+
+externalDocs:
+ description: Wiki for the API's.
+ url: 'https://wiki.onap.org/display/DW/V2+API+Specification'
+
+tags:
+ - name: v2
+ description: |
+ V2 API's
+
+paths:
+ ############################ Project API'S #################################################
+ /projects:
+ post:
+ tags:
+ - Projects
+ summary: Project
+ description: Add a new `project`
+ operationId: addProject
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ description: Project data
+ required: true
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Projects
+ summary: Get all projects
+
+ description: |
+ Get all `projects`
+
+ operationId: getAllProjects
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/MetadataArray'
+ '404':
+ description: No Project found
+ content: {}
+
+ /projects/{project-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ get: # documentation for GET operation for this path
+ tags:
+ - Projects
+ summary: Get project by project name
+
+ description: |
+ Get `project`
+
+ operationId: getProjectByName
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ '404':
+ description: Project not found
+ content: {}
+ put:
+ tags:
+ - Projects
+ summary: Update project
+ description: Update `project`
+ operationId: updateProject
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Project not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ description: Update project object
+ required: true
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Projects
+ summary: Delete project by project name
+
+ description: |
+ Delete `project`
+
+ operationId: deleteProjectByName
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Project not found
+ content: {}
+
+ ############################ Application API'S #################################################
+ /projects/{project-name}/composite-apps:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ post:
+ tags:
+ - Composite Application
+ summary: Add Composite Application
+ description: Add a new `composite application`
+ operationId: addCompositeApplication
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/CompositeAppVersion'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/CompositeAppVersion'
+ description: Composite application definition
+ required: true
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Composite Application
+ summary: Get all Composite Applications
+
+ description: |
+ Get all `composite applications`
+
+ operationId: getAllCompositeApplications
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/CompositeAppVersionArray'
+ '404':
+ description: No Composite App found
+ content: {}
+
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ get: # documentation for GET operation for this path
+ tags:
+ - Composite Application
+ summary: Get Composite Application
+
+ description: |
+ Get `composite application`
+
+ operationId: getCompositeApplicationByName
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/CompositeAppVersion'
+ '404':
+ description: Composite Application not found
+ content: {}
+ put:
+ tags:
+ - Composite Application
+ summary: Update a Composite Application
+ description: Update a `Composite Application`
+ operationId: updateCompositeApplication
+ responses:
+ '200':
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/CompositeAppVersion'
+ description: Success
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Composite Application not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/CompositeAppVersion'
+ description: Composite application definition
+ required: true
+
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Composite Application
+ summary: Delete Composite Application
+
+ description: |
+ Delete `Composite Application`
+
+ operationId: deleteCompositeAppByName
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Composite Application not found
+ content: {}
+
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/apps:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ post:
+ tags:
+ - Composite Application
+ summary: Add app to Composite Application
+ description: Add a new `app to composite application`
+ operationId: addAppToCompositeApplication
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ '405':
+ description: Invalid Input
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ multipart/form-data: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/AppData'
+ required: true
+
+ put:
+ tags:
+ - Composite Application
+ summary: Update app in Composite Application
+ description: Update app in `Composite Application`
+ operationId: updateAppToCompositeApplication
+ responses:
+ '200':
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ description: Success
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Application not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ multipart/form-data: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/AppData'
+ required: true
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Composite Application
+ summary: Get all apps in Composite Application
+
+ description: |
+ Get all `apps in composite application`
+
+ operationId: getAllAppsInCompositeApplication
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/MetadataArray'
+ '404':
+ description: No Apps found in Composite Application found
+ content: {}
+
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}/apps/{app-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/appName'
+ get: # documentation for GET operation for this path
+ tags:
+ - Composite Application
+ summary: Get Application
+
+ description: |
+ Get `application`
+
+ operationId: getAppCompositeApplication
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ application/octet-stream: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/File'
+ multipart/form-data: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/AppData'
+
+ '404':
+ description: Application not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Composite Application
+ summary: Delete Application
+
+ description: |
+ Delete `application`
+
+ operationId: deleteAppToCompositeApplication
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Application not found
+ content: {}
+
+############################ PROFILE API'S #################################################
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/composite-profiles:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ post:
+ tags:
+ - Composite Profile
+ summary: Add Composite Profile
+ description: Add a new `composite profile`
+ operationId: addCompositeProfile
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ description: Composite Profile definition
+ required: true
+
+ put:
+ tags:
+ - Composite Profile
+ summary: Update Composite Profile
+ description: Update `Composite Profile`
+ operationId: updateCompositeProfile
+ responses:
+ '200':
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ description: Success
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Composite Profile not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ description: Composite Profile definition
+ required: true
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Composite Profile
+ summary: Get all Composite Profiles
+
+ description: |
+ Get all `profiles in a composite application`
+
+ operationId: getAllProfilesInCompositeApplication
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/MetadataArray'
+ '404':
+ description: No composite profile found
+ content: {}
+
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}/composite-profile/{composite-profile-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/compositeProfileName'
+ get: # documentation for GET operation for this path
+ tags:
+ - Composite Profile
+ summary: Get Composite Application
+
+ description: |
+ Get `composite profile`
+
+ operationId: getCompositeProfileByName
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ '404':
+ description: Composite Profile not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Composite Profile
+ summary: Delete Composite Profile
+
+ description: |
+ Delete `Composite Profile`
+
+ operationId: deleteCompositeProfileByName
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Composite Profile not found
+ content: {}
+
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/composite-profile/{composite-profile-name}/profiles:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/compositeProfileName'
+ post:
+ tags:
+ - Composite Profile
+ summary: Add app profile to Composite Profile
+ description: Add a `profile for application`
+ operationId: addProfileToCompositeProfile
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ProfileAppSpec'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ multipart/form-data: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/AppData'
+ put:
+ tags:
+ - Composite Profile
+ summary: Update Composite Profile for an app
+ description: Update `Profile`
+ operationId: updateProfile
+ responses:
+ '200':
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ProfileAppSpec'
+ description: Success
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Profile not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ multipart/form-data: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/AppData'
+ required: true
+ get: # documentation for GET operation for this path
+ tags:
+ - Composite Profile
+ summary: Get all app profiles in Composite Profiles
+
+ description: |
+ Get all `app profiles in a composite Profile`
+
+ operationId: getAllProfilesInCompositeProfile
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ProfileAppSpecArray'
+ '404':
+ description: No profile found
+ content: {}
+
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}/composite-profile/{composite-profile-name}/profiles/{profile-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/compositeProfileName'
+ - $ref: '#/components/parameters/profileName'
+ get: # documentation for GET operation for this path
+ tags:
+ - Composite Profile
+ summary: Get profile from Composite Profile
+
+ description: |
+ Get `profile from composite profile`
+
+ operationId: getProfile
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ProfileAppSpec'
+ application/octet-stream: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/File'
+ multipart/form-data: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/AppData'
+
+ '404':
+ description: Profile not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Composite Profile
+ summary: Delete Profile
+
+ description: |
+ Delete `profile in Composite Profile`
+
+ operationId: deleteProfile
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Profile not found
+ content: {}
+
+ # Qurey for Profile - Get profile for app-name
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}/composite-profile/{composite-profile-name}/profiles:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/compositeProfileName'
+ - in: query
+ name: app-name
+ schema:
+ type: string
+ maxLength: 128
+ required: true
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Composite Profile
+ summary: Query profile for an application
+
+ description: |
+ Query `profile for an application`
+
+ operationId: queryProfileForApp
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ProfileAppSpec'
+ application/octet-stream: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/File'
+ multipart/form-data: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/AppData'
+ '404':
+ description: Profile for application not found
+ content: {}
+
+
+############################ GENERIC PLACEMENT INTENT API'S #################################################
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/generic-placement-intents:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ post:
+ tags:
+ - Generic Placement Intent
+ summary: Add Generic Placement Intent
+ description: Add a new `generic placement intent`
+ operationId: addGenericPlacementIntent
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/GenericPlacementIntent'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/GenericPlacementIntent'
+ description: Generic Placement Intent definition
+ required: true
+
+ put:
+ tags:
+ - Generic Placement Intent
+ summary: Update Generic Placement Intent
+ description: Update `Generic Placement Intent`
+ operationId: updateGenericPlacementIntent
+ responses:
+ '200':
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/GenericPlacementIntent'
+ description: Success
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Generic Placement Intent not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/GenericPlacementIntent'
+ description: Generic Placement Intent definition
+ required: true
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Generic Placement Intent
+ summary: Get all Generic Placement Intents
+
+ description: |
+ Get all `Generic Placement Intents`
+
+ operationId: getAllGenericPlacementIntents
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/GenericPlacementIntentArray'
+ '404':
+ description: No Generic Placement Intent found
+ content: {}
+
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}/generic-placement-intents/{generic-placement-intent-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/genericPlacementIntentName'
+ get: # documentation for GET operation for this path
+ tags:
+ - Generic Placement Intent
+ summary: Get Generic Placement Intent
+
+ description: |
+ Get `generic placement intent`
+
+ operationId: getGenericPlacementIntentByName
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/GenericPlacementIntent'
+ '404':
+ description: Generic Placement Intent not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Generic Placement Intent
+ summary: Delete Generic Placement Intent
+
+ description: |
+ Delete `Generic Placement Intent`
+
+ operationId: deleteGenericPlacementIntentByName
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Generic Placement Intent not found
+ content: {}
+
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/generic-placement-intents/{generic-placement-intent-name}/app-intents:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/genericPlacementIntentName'
+ post:
+ tags:
+ - Generic Placement Intent
+ summary: Add intent for an application
+ description: Add a `intent for application`
+ operationId: addIntentToGenericPlacementIntent
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/GenericPlacementAppIntent'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/GenericPlacementAppIntent'
+ put:
+ tags:
+ - Generic Placement Intent
+ summary: Update intent for an application
+ description: Update `generic placement intent for application`
+ operationId: updateIntentToGenericPlacementIntent
+ responses:
+ '200':
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/GenericPlacementAppIntent'
+ description: Success
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Generic placement intent not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ application/json: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/GenericPlacementAppIntent'
+ required: true
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Generic Placement Intent
+ summary: Get all Intents in Generic Placement
+
+ description: |
+ Get all ` Intents in Generic Placement Intent`
+
+ operationId: getAllIntentsInGenericPlacementIntents
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/GenericPlacementAppIntentArray'
+ '404':
+ description: No Generic Placement Intent found
+ content: {}
+
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}/generic-placement-intents/{generic-placement-intent-name}/app-intents/{intent-name}:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/genericPlacementIntentName'
+ - $ref: '#/components/parameters/intentName'
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Generic Placement Intent
+ summary: Get intent
+
+ description: |
+ Get `generic placement intent`
+
+ operationId: getIntentfromGenericPlacementIntent
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/GenericPlacementAppIntent'
+
+ '404':
+ description: Intent not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Generic Placement Intent
+ summary: Delete intent
+
+ description: |
+ Delete `generic placement intent`
+
+ operationId: deleteIntentFromGenericPlacementIntent
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Intent not found
+ content: {}
+
+ # Qurey for Intent - Get intent for app-name
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}/generic-placement-intents/{generic-placement-intent-name}/app-intents:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/genericPlacementIntentName'
+ - in: query
+ name: app-name
+ schema:
+ type: string
+ maxLength: 128
+ required: true
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Generic Placement Intent
+ summary: Query intent for an application
+
+ description: |
+ Query `generic placement intent for application`
+
+ operationId: queryIntentfromGenericPlacementIntent
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/GenericPlacementAppIntent'
+ '404':
+ description: Generic Placement Intent for application not found
+ content: {}
+
+############################ Deployment Intent Group API'S #################################################
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/deployment-intent-groups:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ post:
+ tags:
+ - Deployment Intent Group
+ summary: Add Deployment Intent Group
+ description: Add a new `deployment intent group`
+ operationId: addDeploymentIntentGroup
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/DeploymentGroupIntent'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/DeploymentGroupIntent'
+ description: Deployment Intent Group definition
+ required: true
+
+ put:
+ tags:
+ - Deployment Intent Group
+ summary: Update Deployment Intent Group
+ description: Update `Deployment Intent Group`
+ operationId: updateDeploymentIntentGroup
+ responses:
+ '200':
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/DeploymentGroupIntent'
+ description: Success
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Deployment Intent Group not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/DeploymentGroupIntent'
+ description: Deployment Intent Group definition
+ required: true
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Deployment Intent Group
+ summary: Get all Deployment Intent Group
+
+ description: |
+ Get all `Deployment Intent Group`
+
+ operationId: getAllDeploymentIntentGroup
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/DeploymentGroupIntentArray'
+ '404':
+ description: No Deployment Intent Group found
+ content: {}
+
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}/deployment-intent-groups/{deployment-intent-group-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/deploymentIntentGroupName'
+ get: # documentation for GET operation for this path
+ tags:
+ - Deployment Intent Group
+ summary: Get Deployment Intent Group
+
+ description: |
+ Get `Deployment Intent Group`
+
+ operationId: getDeploymentIntentGroupByName
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/DeploymentGroupIntent'
+ '404':
+ description: Deployment Intent Group not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Deployment Intent Group
+ summary: Delete Deployment Intent Group
+
+ description: |
+ Delete `Deployment Intent Group`
+
+ operationId: deleteDeploymentIntentGroupByName
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Deployment Intent Group not found
+ content: {}
+
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/deployment-intent-groups/{deployment-intent-group-name}/intents:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/deploymentIntentGroupName'
+ post:
+ tags:
+ - Deployment Intent Group
+ summary: Add Intent
+ description: Add `deployment Intent`
+ operationId: addIntentToDeploymentIntentGroup
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/DeploymentIntent'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/DeploymentIntent'
+ put:
+ tags:
+ - Deployment Intent Group
+ summary: Update intent
+ description: Update `deployment intent`
+ operationId: updateIntentToDeploymentIntentGroup
+ responses:
+ '200':
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/DeploymentIntent'
+ description: Success
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Intent not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ application/json: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/DeploymentIntent'
+ required: true
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Deployment Intent Group
+ summary: Get all intents in Deployment Intent Group
+
+ description: |
+ Get all `intents in deployment intent group`
+
+ operationId: getAllIntentsInDeploymentIntentGroup
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/DeploymentGroupIntentArray'
+ '404':
+ description: No Deployment Intent Group found
+ content: {}
+
+
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}/deployment-intent-groups/{deployment-intent-group-name}/intents/{intent-name}:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/deploymentIntentGroupName'
+ - $ref: '#/components/parameters/intentName'
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Deployment Intent Group
+ summary: Get intent for an application
+
+ description: |
+ Get `Deployment Intent`
+
+ operationId: getIntentForDeploymentIntentGroup
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/DeploymentIntent'
+
+ '404':
+ description: Deployment Intent not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Deployment Intent Group
+ summary: Delete intent
+
+ description: |
+ Delete `intent`
+
+ operationId: deleteIntentFromDeploymentIntentGroup
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Deployment intent not found
+ content: {}
+ #Query
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}/deployment-intent-groups/{deployment-intent-group-name}/intents:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/deploymentIntentGroupName'
+ - in: query
+ name: intent
+ schema:
+ type: string
+ maxLength: 128
+ required: true
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Deployment Intent Group
+ summary: Query intent
+
+ description: |
+ Query `Deployment Intent`
+
+ operationId: queryIntentForDeploymentIntentGroup
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/DeploymentIntent'
+ '404':
+ description: Deployment Intent not found
+ content: {}
+
+####################Lifecycle Management#######################################
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/deployment-intent-groups/{deployment-intent-group-name}/approve:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/deploymentIntentGroupName'
+ post:
+ tags:
+ - Deployment Lifecycle
+ summary: Approve a Deployment
+ description: Approve a Deployment
+ operationId: approveDeploymentIntentGroup
+ responses:
+ '201':
+ description: Success
+ content: {}
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content: {}
+
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/deployment-intent-groups/{deployment-intent-group-name}/instantiate:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/deploymentIntentGroupName'
+ post:
+ tags:
+ - Deployment Lifecycle
+ summary: Instantiate a Deployment
+ description: Instantiate a Deployment
+ operationId: instantiateDeploymentIntentGroup
+ responses:
+ '201':
+ description: Success
+ content: {}
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content: {}
+
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/deployment-intent-groups/{deployment-intent-group-name}/destroy:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/deploymentIntentGroupName'
+ post:
+ tags:
+ - Deployment Lifecycle
+ summary: Destroy a Deployment
+ description: Destroy a Deployment
+ operationId: destroyDeploymentIntentGroup
+ responses:
+ '200':
+ description: Success
+ content: {}
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content: {}
+
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/deployment-intent-groups/{deployment-intent-group-name}/status:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/deploymentIntentGroupName'
+ post:
+ tags:
+ - Deployment Lifecycle
+ summary: Status of Deployment
+ description: Status of Deployment
+ operationId: statusDeploymentIntentGroup
+ responses:
+ '200':
+ description: Success
+ content: {}
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content: {}
+
+############################ Controller Registration API'S #################################################
+ /controllers:
+ post:
+ tags:
+ - Controller Registration
+ summary: Controller Registration
+ description: Add a new `controller`
+ operationId: addController
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Controller'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Controller'
+ description: Controller Info
+ required: true
+ put:
+ tags:
+ - Controller Registration
+ summary: Update controller
+ description: Update `controller`
+ operationId: updateController
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Controller'
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Controller not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Controller'
+ description: Update controllers object
+ required: true
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Controller Registration
+ summary: Get all controllers
+
+ description: |
+ Get all `controllers`
+
+ operationId: getControllers
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ControllerArray'
+ '404':
+ description: No controllers found
+ content: {}
+
+ /controllers/{controller-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/controllerName'
+ get: # documentation for GET operation for this path
+ tags:
+ - Controller Registration
+ summary: Get controller by name
+
+ description: |
+ Get `controller`
+
+ operationId: getController
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Controller'
+ '404':
+ description: Controller not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Controller Registration
+ summary: Delete controller
+
+ description: |
+ Delete `controller`
+
+ operationId: deleteController
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Controller not found
+ content: {}
+
+############################ Cluster Provider API'S #################################################
+ /cluster-providers:
+ post:
+ tags:
+ - Cluster Providers
+ summary: Cluster Providers
+ description: Add a new `cluster provider`
+ operationId: addClusterProvider
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ description: Cluster Providers Info
+ required: true
+ put:
+ tags:
+ - Cluster Providers
+ summary: Update cluster provider
+ description: Update `cluster providers`
+ operationId: updateClusterProviders
+ responses:
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Cluster Provider not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ description: Update cluster provider object
+ required: true
+
+ get: # documentation for GET operation for this path
+ tags:
+ - Cluster Providers
+ summary: Get all cluster providers
+
+ description: |
+ Get all `cluster providers`
+
+ operationId: getAllClusterProviders
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ '404':
+ description: No cluster provider found
+ content: {}
+
+ /cluster-providers/{cluster-providers-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ get: # documentation for GET operation for this path
+ tags:
+ - Cluster Providers
+ summary: Get cluster provider by name
+
+ description: |
+ Get `cluster provider`
+
+ operationId: getClusterProviderByName
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ '404':
+ description: Cluster Provider not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Cluster Providers
+ summary: Delete cluster provider by name
+
+ description: |
+ Delete `cluster provider`
+
+ operationId: deleteClusterProviderByName
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Cluster Provider not found
+ content: {}
+
+ /cluster-providers/{cluster-providers-name}/clusters:
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ post:
+ tags:
+ - Clusters
+ summary: Add Cluster
+ description: Add a new `cluster`
+ operationId: addClusterToClusterProvider
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ multipart/form-data: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/AppData'
+ put:
+ tags:
+ - Clusters
+ summary: Update Cluster
+ description: Update `cluster`
+ operationId: updateClusterToClusterProvider
+ responses:
+ '200':
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ description: Success
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Cluster not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ multipart/form-data: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/AppData'
+ required: true
+
+ /cluster-providers/{cluster-providers-name}/clusters/{cluster-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ - $ref: '#/components/parameters/clusterName'
+ get: # documentation for GET operation for this path
+ tags:
+ - Clusters
+ summary: Get Cluster
+
+ description: |
+ Get `cluster`
+
+ operationId: getClusterForClusterProvider
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ application/octet-stream: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/File'
+ multipart/form-data: # Media type
+ schema: # Request payload
+ $ref: '#/components/schemas/AppData'
+
+ '404':
+ description: Cluster not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Clusters
+ summary: Delete cluster
+
+ description: |
+ Delete `cluster`
+
+ operationId: deleteClusterFromClusterProvider
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Cluster not found
+ content: {}
+
+############################ Cluster Labels API'S #################################################
+ /cluster-providers/{cluster-providers-name}/clusters/{cluster-name}/labels:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ - $ref: '#/components/parameters/clusterName'
+ post:
+ tags:
+ - Clusters
+ summary: Add label to Cluster
+ description: Add a new label to `cluster`
+ operationId: addLabelToCluster
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ClusterLabel'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ClusterLabel'
+ description: Cluster Label
+ required: true
+ get: # documentation for GET operation for this path
+ tags:
+ - Clusters
+ summary: Get all Labels
+
+ description: |
+ Get all `labels`
+
+ operationId: getAllLabelsForCluster
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ClusterLabel'
+ '404':
+ description: No labels found
+ content: {}
+
+ /cluster-providers/{cluster-providers-name}/clusters/{cluster-name}/labels/{cluster-label-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ - $ref: '#/components/parameters/clusterName'
+ - $ref: '#/components/parameters/clusterLabelName'
+ get: # documentation for GET operation for this path
+ tags:
+ - Clusters
+ summary: Get label
+
+ description: |
+ Get `cluster label`
+
+ operationId: getLabelForCluster
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ClusterLabel'
+ '404':
+ description: label not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Clusters
+ summary: Delete cluster label
+
+ description: |
+ Delete `label`
+
+ operationId: deleteLabelForCluster
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Label not found
+ content: {}
+
+# Qurey for label - Get clusters for label
+ /cluster-providers/{cluster-providers-name}/clusters/:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ - in: query
+ name: label
+ schema:
+ type: string
+ maxLength: 128
+ required: true
+ get: # documentation for GET operation for this path
+ tags:
+ - Clusters
+ summary: Get clusters for label
+
+ description: |
+ Get `clusters for label`
+ operationId: getClustersForLabel
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/MetadataArray'
+ '404':
+ description: label not found
+ content: {}
+
+############################ Cluster Key Value API'S #################################################
+ /cluster-providers/{cluster-providers-name}/clusters/{cluster-name}/kv-pairs:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ - $ref: '#/components/parameters/clusterName'
+ post:
+ tags:
+ - Clusters
+ summary: Add kv pair to Cluster
+ description: Add kv pair to `cluster`
+ operationId: addKvpairToCluster
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ClusterKv'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ClusterKv'
+ description: Cluster KV Pair
+ required: true
+ get: # documentation for GET operation for this path
+ tags:
+ - Clusters
+ summary: Get all KV Pairs
+
+ description: |
+ Get all `KV Pairs`
+
+ operationId: getAllKvpairForCluster
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ClusterKv'
+ '404':
+ description: No labels found
+ content: {}
+
+ /cluster-providers/{cluster-providers-name}/clusters/{cluster-name}/kv-pairs/{kv-pair-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ - $ref: '#/components/parameters/clusterName'
+ - $ref: '#/components/parameters/clusterKvpairName'
+ get: # documentation for GET operation for this path
+ tags:
+ - Clusters
+ summary: Get KV Pair
+
+ description: |
+ Get `KV pair` for cluster
+
+ operationId: getKvpairForCluster
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ClusterKv'
+ '404':
+ description: KV pair not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Clusters
+ summary: Delete cluster KV pair
+
+ description: |
+ Delete `KV pair`
+
+ operationId: deleteKvpairForCluster
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: KV pair not found
+ content: {}
+
+ #Query Key Value
+ /cluster-providers/{cluster-providers-name}/clusters/{cluster-name}/kv-pairs/{kv-pair-name}/:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ - $ref: '#/components/parameters/clusterName'
+ - $ref: '#/components/parameters/clusterKvpairName'
+ - in: query
+ name: key
+ schema:
+ type: string
+ maxLength: 128
+ required: true
+ get: # documentation for GET operation for this path
+ tags:
+ - Clusters
+ summary: Query KV Pair
+
+ description: |
+ Query `KV pair` for cluster
+
+ operationId: queryKvpairForCluster
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Kv'
+ '404':
+ description: KV pair not found
+ content: {}
+
+############################ Cluster Virtual Networks API'S #################################################
+ /cluster-providers/{cluster-providers-name}/clusters/{cluster-name}/networks:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ - $ref: '#/components/parameters/clusterName'
+ post:
+ tags:
+ - Networks
+ summary: Add virtual network in cluster
+ description: Add a `virtual network in cluster`
+ operationId: addVirtualNetworkToCluster
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/VirtualNetwork'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/VirtualNetwork'
+ description: Add virtual network
+ required: true
+ get: # documentation for GET operation for this path
+ tags:
+ - Networks
+ summary: Get all cluster virtual networks
+
+ description: |
+ Get all `virtual networks for a cluster`
+
+ operationId: getAllVirtualNetworksForCluster
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/VirtualNetwork'
+ '404':
+ description: No virtual networks found
+ content: {}
+
+ /cluster-providers/{cluster-providers-name}/clusters/{cluster-name}/networks/{network-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ - $ref: '#/components/parameters/clusterName'
+ - $ref: '#/components/parameters/clusterNetworkName'
+ get: # documentation for GET operation for this path
+ tags:
+ - Networks
+ summary: Get virtual network
+
+ description: |
+ Get `virtual network`
+
+ operationId: getVirtualNetworkForCluster
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/VirtualNetwork'
+ '404':
+ description: Network not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Networks
+ summary: Delete virtual network
+
+ description: |
+ Delete `virtual network`
+
+ operationId: deleteVirtualNetworkForCluster
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Network not found
+ content: {}
+
+############################ Cluster Provider Networks API'S #################################################
+ /cluster-providers/{cluster-providers-name}/clusters/{cluster-name}/provider-networks:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ - $ref: '#/components/parameters/clusterName'
+ post:
+ tags:
+ - Networks
+ summary: Add provider network in cluster
+ description: Add a `provider network in cluster`
+ operationId: addProviderNetworkToCluster
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ProviderNetwork'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ProviderNetwork'
+ description: Add provider network
+ required: true
+ get: # documentation for GET operation for this path
+ tags:
+ - Networks
+ summary: Get all cluster provider networks
+
+ description: |
+ Get all `provider networks for a cluster`
+
+ operationId: getAllProviderNetworksForCluster
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ProviderNetwork'
+ '404':
+ description: No provider networks found
+ content: {}
+
+ /cluster-providers/{cluster-providers-name}/clusters/{cluster-name}/provider-networks/{network-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ - $ref: '#/components/parameters/clusterName'
+ - $ref: '#/components/parameters/clusterNetworkName'
+ get: # documentation for GET operation for this path
+ tags:
+ - Networks
+ summary: Get Provider Network
+
+ description: |
+ Get `provider network`
+
+ operationId: getProviderNetworkForCluster
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/ProviderNetwork'
+ '404':
+ description: Provider network not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Networks
+ summary: Delete Provider Network
+
+ description: |
+ Delete `Provider Network`
+
+ operationId: deleteProviderNetworkForCluster
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Name not found
+ content: {}
+
+ /cluster-providers/{cluster-providers-name}/clusters/{cluster-name}/apply:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ - $ref: '#/components/parameters/clusterName'
+ post:
+ tags:
+ - Networks
+ summary: Apply configuration for the cluster
+ description: Apply configuration for the cluster to create networks
+ operationId: applyNetworksForCluster
+ responses:
+ '201':
+ description: Success
+ content: {}
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content: {}
+
+ /cluster-providers/{cluster-providers-name}/clusters/{cluster-name}/terminate:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/clusterProviderName'
+ - $ref: '#/components/parameters/clusterName'
+ post:
+ tags:
+ - Networks
+ summary: Apply configuration for the cluster
+ description: Apply configuration for the cluster to create networks
+ operationId: terminateNetworksForCluster
+ responses:
+ '201':
+ description: Success
+ content: {}
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content: {}
+
+######################## Network Controller Intent API's##########################################
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/network-controller-intent:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ post:
+ tags:
+ - Network Controller Intent
+ summary: Network Controller Intent API's
+ description: Add a new `network controller intent`
+ operationId: addNetworkControllerIntent
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ put:
+ tags:
+ - Network Controller Intent
+ summary: Update Network Controller Intent
+ description: Update `Network Controller Intent`
+ operationId: updateNetworkControllerIntent
+ responses:
+ '200':
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ description: Success
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Network Controller Intent not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ required: true
+
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}/network-controller-intent/{net-control-intent}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/netControlIntent'
+ get: # documentation for GET operation for this path
+ tags:
+ - Network Controller Intent
+ summary: Get Network Controller Intent
+
+ description: |
+ Get `network controller intent`
+
+ operationId: getNetworkControllerIntent
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/Metadata'
+ '404':
+ description: Network Controller Intent not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Network Controller Intent
+ summary: Delete Network Controller Intent
+
+ description: |
+ Delete `Network Controller Intent`
+
+ operationId: deleteNetworkControllerIntent
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Network Controller Intent not found
+ content: {}
+################## Workload Intents##################################
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/network-controller-intent/{net-control-intent}/workload-intents:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/netControlIntent'
+ post:
+ tags:
+ - Network Controller Intent
+ summary: Network Controller Workload Intent API's
+ description: Add a new `network controller workload intent`
+ operationId: addNetworkControllerWorkloadIntent
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/NetworkWorloadSpec'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/NetworkWorloadSpec'
+ put:
+ tags:
+ - Network Controller Intent
+ summary: Update Network Controller Workload Intent
+ description: Update `Network Controller Workload Intent`
+ operationId: updateNetworkControllerWorkloadIntent
+ responses:
+ '200':
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/NetworkWorloadSpec'
+ description: Success
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Network Controller Workload Intent not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/NetworkWorloadSpec'
+ required: true
+
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}/network-controller-intent/{net-control-intent}/workload-intents/{workload-intent-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/netControlIntent'
+ - $ref: '#/components/parameters/netControlWorkloadIntent'
+ get: # documentation for GET operation for this path
+ tags:
+ - Network Controller Intent
+ summary: Get Network Controller Workload Intent
+
+ description: |
+ Get `network controller workload intent`
+
+ operationId: getNetworkControllerWorkloadIntent
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/NetworkWorloadSpec'
+ '404':
+ description: Network Controller Workload Intent not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Network Controller Intent
+ summary: Delete Network Controller Workload Intent
+
+ description: |
+ Delete `Network Controller Workload Intent`
+
+ operationId: deleteNetworkControllerWorkloadIntent
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Network Controller Workload Intent not found
+ content: {}
+
+################## Workload Intents Interfaces ##################################
+ /projects/{project-name}/composite-apps/{composite-app-name}/{composite-app-version}/network-controller-intent/{net-control-intent}/workload-intents/{workload-intent-name}/interfaces:
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/netControlIntent'
+ - $ref: '#/components/parameters/netControlWorkloadIntent'
+ post:
+ tags:
+ - Network Controller Intent
+ summary: Network Controller Workload Interface API's
+ description: Add a new `network controller workload interface`
+ operationId: addNetworkControllerWorkloadInterface
+ responses:
+ '201':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/NetworkWorloadInterface'
+ '405':
+ description: Invalid Input
+ content: {}
+ requestBody:
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/NetworkWorloadInterface'
+ put:
+ tags:
+ - Network Controller Intent
+ summary: Update Network Controller Workload Interface
+ description: Update `Network Controller Workload Interface`
+ operationId: updateNetworkControllerWorkloadInterface
+ responses:
+ '200':
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/NetworkWorloadInterface'
+ description: Success
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Network Controller Workload Interface not found
+ content: {}
+ # request body documentation
+ requestBody:
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/NetworkWorloadInterface'
+ required: true
+
+ /projects/{project-name}composite-apps/{composite-app-name}/{composite-app-version}/network-controller-intent/{net-control-intent}/workload-intents/{workload-intent-name}/interfaces/{interface-name}:
+ # parameters list that are used with each operation for this path
+ parameters:
+ - $ref: '#/components/parameters/projectName'
+ - $ref: '#/components/parameters/compositeAppName'
+ - $ref: '#/components/parameters/compositeAppVersion'
+ - $ref: '#/components/parameters/netControlIntent'
+ - $ref: '#/components/parameters/netControlWorkloadIntent'
+ - $ref: '#/components/parameters/netControlWorkloadInterface'
+ get: # documentation for GET operation for this path
+ tags:
+ - Network Controller Intent
+ summary: Get Network Controller Workload Interface
+
+ description: |
+ Get `network controller workload interface`
+
+ operationId: getNetworkControllerWorkloadInterface
+ responses: # list of responses
+ '200':
+ description: Success
+ content:
+ application/json: # operation response mime type
+ schema:
+ $ref: '#/components/schemas/NetworkWorloadInterface'
+ '404':
+ description: Network Controller Workload Interface not found
+ content: {}
+ delete: # documentation for DELETE operation for this path
+ tags:
+ - Network Controller Intent
+ summary: Delete Network Controller Workload Interface
+
+ description: |
+ Delete `Network Controller Workload Interface`
+
+ operationId: deleteNetworkControllerWorkloadInterface
+ responses: # list of responses
+ '204':
+ description: Deleted
+ content: {}
+ '400':
+ description: Invalid data
+ content: {}
+ '404':
+ description: Network Controller Workload Interface not found
+ content: {}
+
+
+#########################SCHEMAS####################################################
+# An object to hold reusable parts that can be used across the definition
+components:
+ schemas:
+ MetadataBase:
+ type: object
+ properties:
+ name:
+ description: Name of the resource
+ type: string
+ maxLength: 128
+ example: "ResName"
+ description:
+ description: Description for the resource
+ type: string
+ maxLength: 1024
+ example: "Resource description"
+ userData1:
+ description: User relevant data for the resource
+ type: string
+ maxLength: 512
+ example: "Some data"
+ userData2:
+ description: User relevant data for the resource
+ type: string
+ maxLength: 512
+ example: "Some more data"
+ Metadata:
+ type: object
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ MetadataArray:
+ type: array
+ items:
+ $ref: '#/components/schemas/Metadata'
+ VersionSpec:
+ type: object
+ properties:
+ version:
+ description: Composite Application Version
+ type: string
+ maxLength: 128
+ example: "v1"
+ CompositeAppVersion:
+ type: object
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ spec:
+ $ref: '#/components/schemas/VersionSpec'
+ CompositeAppVersionArray:
+ type: array
+ items:
+ $ref: '#/components/schemas/CompositeAppVersion'
+ File:
+ type: string
+ format: binary
+ maxLength: 1073741824
+ AppData:
+ type: object
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ file: # Part 2 (Helm chart in tar.gz format)
+ $ref: '#/components/schemas/File'
+ ProfileAppSpec:
+ type: object
+ properties:
+ spec:
+ type: object
+ description: AppProfileSpec contains the Spec for AppProfiles
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ app-name:
+ type: string
+ description: Application Name
+ maxLength: 128
+ example: "Application1"
+ required:
+ - app-name
+ ProfileAppSpecArray:
+ type: array
+ items:
+ $ref: '#/components/schemas/ProfileAppSpec'
+ ProfileAppData:
+ type: object
+ properties:
+ file: # Part 2 (Helm chart in tar.gz format)
+ $ref: '#/components/schemas/File'
+ metadata:
+ $ref: '#/components/schemas/ProfileAppSpec'
+ GenericPlacementIntent:
+ type: object
+ properties:
+ spec:
+ type: object
+ description: Spec
+ properties:
+ logical-cloud:
+ type: string
+ description: Logical Cloud to use for this intent
+ maxLength: 128
+ example: "cloud1"
+ required:
+ - logical-cloud
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ GenericPlacementIntentArray:
+ type: array
+ items:
+ $ref: '#/components/schemas/GenericPlacementIntent'
+ GenericPlacementAppIntentSpec:
+ type: object
+ description: ''
+ properties:
+ app-name:
+ type: string
+ maxLength: 128
+ example: "appl"
+ allOf:
+ items:
+ description: AllOf ProviderName, ClusterName, ClusterLabelName and AnyOfArray
+ properties:
+ anyOf:
+ items:
+ description: AnyOf consists of Array of ProviderName & ClusterLabelNames
+ properties:
+ cluster-label-name:
+ type: string
+ maxLength: 128
+ example: "east"
+ cluster-name:
+ type: string
+ maxLength: 128
+ example: "cluster1"
+ provider-name:
+ type: string
+ maxLength: 128
+ example: "provider1"
+ type: object
+ type: array
+ cluster-label-name:
+ type: string
+ maxLength: 128
+ example: "west"
+ cluster-name:
+ type: string
+ maxLength: 128
+ example: "cluster2"
+ provider-name:
+ type: string
+ maxLength: 128
+ example: "provider2"
+ type: object
+ type: array
+ anyOf:
+ items:
+ description: AnyOf consists of Array of ProviderName & ClusterLabelNames
+ properties:
+ cluster-label-name:
+ type: string
+ maxLength: 128
+ example: "east"
+ cluster-name:
+ type: string
+ maxLength: 128
+ example: "cluster1"
+ provider-name:
+ type: string
+ maxLength: 128
+ example: "provider1"
+ type: object
+ type: array
+ GenericPlacementAppIntent:
+ type: object
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ spec:
+ $ref: '#/components/schemas/GenericPlacementAppIntentSpec'
+ GenericPlacementAppIntentArray:
+ type: array
+ items:
+ $ref: '#/components/schemas/GenericPlacementAppIntent'
+ DeploymentIntentSpec:
+ type: object
+ description: DepSpecData has profile, version, OverrideValuesObj
+ properties:
+ override-values:
+ items:
+ description: OverrideValues has appName and ValuesObj
+ properties:
+ app-name:
+ type: string
+ values:
+ additionalProperties:
+ type: string
+ maxLength: 128
+ type: object
+ required:
+ - app-name
+ - values
+ type: object
+ type: array
+ profile:
+ type: string
+ maxLength: 128
+ version:
+ type: string
+ maxLength: 128
+ required:
+ - profile
+ - version
+ DeploymentGroupIntent:
+ type: object
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ spec:
+ $ref: '#/components/schemas/DeploymentIntentSpec'
+ DeploymentGroupIntentArray:
+ type: array
+ items:
+ $ref: '#/components/schemas/DeploymentGroupIntent'
+ DeploymentIntent:
+ type: object
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ spec:
+ type: object
+ description: IntentSpecData has Intent
+ properties:
+ intent:
+ additionalProperties:
+ type: string
+ maxLength: 128
+ example:
+ generic-placement-intent: gpi-name
+ type: object
+ required:
+ - intent
+ DeploymentIntentArray:
+ type: array
+ items:
+ $ref: '#/components/schemas/DeploymentIntent'
+ Controller:
+ type: object
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ spec:
+ type: object
+ properties:
+ host:
+ type: string
+ description: Controller reachibility information
+ maxLength: 128
+ example: "10.7.100.4"
+ port:
+ type: string
+ description: Port for controller
+ maxLength: 128
+ example: "9029"
+ type:
+ type: string
+ description: Type of controller (placement, action are 2 types supported)
+ maxLength: 48
+ example: "placement"
+ priority:
+ type: string
+ description: Priority of controller to be called
+ maxLength: 128
+ example: "4"
+ required:
+ - host
+ - port
+ - type
+ - priority
+ ControllerArray:
+ type: array
+ items:
+ $ref: '#/components/schemas/Controller'
+ ClusterLabel:
+ type: object
+ properties:
+ label-name:
+ type: string
+ description: Logical Cloud to use for this intent
+ maxLength: 128
+ example: "cluster-label-1"
+ ClusterKv:
+ type: object
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ spec:
+ properties:
+ kv:
+ items:
+ additionalProperties:
+ type: string
+ maxLength: 128
+ type: object
+ type: array
+ required:
+ - kv
+ type: object
+ required:
+ - metadata
+ - spec
+ Kv:
+ type: object
+ properties:
+ value:
+ type: string
+ maxLength: 128
+
+ VirtualNetwork:
+ type: object
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ spec:
+ properties:
+ cniType:
+ type: string
+ maxLength: 128
+ ipv4Subnets:
+ items:
+ properties:
+ excludeIps:
+ type: string
+ maxLength: 1024
+ gateway:
+ type: string
+ maxLength: 128
+ name:
+ type: string
+ maxLength: 128
+ subnet:
+ type: string
+ maxLength: 128
+ required:
+ - excludeIps
+ - gateway
+ - name
+ - subnet
+ type: object
+ type: array
+ ProviderNetwork:
+ type: object
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ spec:
+ properties:
+ cniType:
+ type: string
+ maxLength: 128
+ ipv4Subnets:
+ items:
+ properties:
+ excludeIps:
+ type: string
+ maxLength: 128
+ gateway:
+ type: string
+ maxLength: 128
+ name:
+ type: string
+ maxLength: 128
+ subnet:
+ type: string
+ maxLength: 128
+ required:
+ - excludeIps
+ - gateway
+ - name
+ - subnet
+ type: object
+ type: array
+ providerNetType:
+ type: string
+ maxLength: 128
+ vlan:
+ properties:
+ logicalInterfaceName:
+ type: string
+ maxLength: 128
+ nodeLabelList:
+ items:
+ type: string
+ maxLength: 128
+ type: array
+ providerInterfaceName:
+ type: string
+ maxLength: 128
+ vlanID:
+ type: string
+ maxLength: 128
+ vlanNodeSelector:
+ type: string
+ maxLength: 128
+ required:
+ - logicalInterfaceName
+ - nodeLabelList
+ - providerInterfaceName
+ - vlanID
+ - vlanNodeSelector
+ type: object
+ required:
+ - cniType
+ - ipv4Subnets
+ - providerNetType
+ - vlan
+ type: object
+ RouteBasedChain:
+ type: object
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ spec:
+ properties:
+ chainType:
+ type: string
+ maxLength: 128
+ routingSpec:
+ properties:
+ leftNetwork:
+ items:
+ properties:
+ gatewayIp:
+ type: string
+ maxLength: 128
+ networkName:
+ type: string
+ maxLength: 128
+ subnet:
+ type: string
+ maxLength: 128
+ required:
+ - gatewayIp
+ - networkName
+ - subnet
+ type: object
+ type: array
+ namespace:
+ type: string
+ maxLength: 128
+ networkChain:
+ type: string
+ maxLength: 128
+ rightNetwork:
+ items:
+ properties:
+ gatewayIp:
+ type: string
+ maxLength: 128
+ networkName:
+ type: string
+ maxLength: 128
+ subnet:
+ type: string
+ maxLength: 128
+ required:
+ - gatewayIp
+ - networkName
+ - subnet
+ type: object
+ type: array
+ required:
+ - leftNetwork
+ - namespace
+ - networkChain
+ - rightNetwork
+ type: object
+ required:
+ - chainType
+ - routingSpec
+ type: object
+ NetworkWorloadSpec:
+ type: object
+ properties:
+ spec:
+ type: object
+ description: Newtwork Workload Intent
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ spec:
+ type: object
+ properties:
+ application-name:
+ type: string
+ description: Application Name
+ maxLength: 128
+ example: "Application1"
+ workload-resource:
+ type: string
+ description: Name of the workload
+ maxLength: 254
+ example: "firewall"
+ type:
+ type: string
+ description: Type of the workload
+ maxLength: 128
+ example: "deployment"
+ NetworkWorloadInterface:
+ type: object
+ properties:
+ metadata:
+ $ref: '#/components/schemas/MetadataBase'
+ spec:
+ type: object
+ properties:
+ interface:
+ type: string
+ description: interface Name
+ maxLength: 128
+ example: "eth0"
+ name:
+ type: string
+ description: Name of the network
+ maxLength: 128
+ example: "provider-1"
+ defaultGateway:
+ type: boolean
+ description: Is this interface default gateway
+ maxLength: 128
+ example: "false"
+ ipAddress:
+ type: string
+ description: Name of the network
+ maxLength: 128
+ example: "0.0.0.0"
+ macAddress:
+ type: string
+ description: Name of the network
+ maxLength: 128
+ example: "x.x.x.x"
+ required:
+ - interface
+ - name
+ parameters:
+ projectName:
+ name: project-name
+ in: path
+ description: Name of the project
+ required: true
+ schema:
+ type: string
+ compositeAppName:
+ name: composite-app-name
+ in: path
+ description: Name of the Composite Application
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ compositeAppVersion:
+ name: composite-app-version
+ in: path
+ description: Version of the Composite Application
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ appName:
+ name: app-name
+ in: path
+ description: Name of the Application
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ compositeProfileName:
+ name: composite-profile-name
+ in: path
+ description: Name of the Composite Profile
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ profileName:
+ name: profile-name
+ in: path
+ description: Name of the Profile
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ genericPlacementIntentName:
+ name: generic-placement-intent-name
+ in: path
+ description: Name of Generic Placement Intent
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ intentName:
+ name: intent-name
+ in: path
+ description: Name of Generic Placement Intent for application
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ deploymentIntentGroupName:
+ name: deployment-intent-group-name
+ in: path
+ description: Name of Generic Placement Intent for application
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ clusterProviderName:
+ name: cluster-providers-name
+ in: path
+ description: Name of the cluster provider
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ clusterName:
+ name: cluster-name
+ in: path
+ description: Name of the cluster
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ clusterLabelName:
+ name: cluster-label-name
+ in: path
+ description: Name of the cluster
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ clusterKvpairName:
+ name: kv-pair-name
+ in: path
+ description: Name of the cluster
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ clusterNetworkName:
+ name: network-name
+ in: path
+ description: Name of the network
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ netControlIntent:
+ name: net-control-intent
+ in: path
+ description: Name of the network
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ netControlWorkloadIntent:
+ name: workload-intent-name
+ in: path
+ description: Name of the network
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ netControlWorkloadInterface:
+ name: interface-name
+ in: path
+ description: Name of the network
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+ controllerName:
+ name: controller-name
+ in: path
+ description: Controller name
+ required: true
+ schema:
+ type: string
+ maxLength: 128
+