# ============LICENSE_START=======================================================
# Copyright (C) 2022 Nordix Foundation
# ================================================================================
# 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.
#
# SPDX-License-Identifier: Apache-2.0
# ============LICENSE_END=========================================================
openapi: 3.0.1
info:
title: Api Documentation
description: Api Documentation
termsOfService: urn:tos
contact: {}
license:
name: Apache 2.0
url: http://www.apache.org/licenses/LICENSE-2.0
version: "1.0"
servers:
- url: https://{server}
variables:
server:
default: onap/acm/v3
description: This value is assigned by the service provider
tags:
- name: Automation Composition Definition
description: Automation Composition Controller
paths:
/compositions:
get:
tags:
- Automation Composition Definition
summary: Query the commissioned automation composition definitions
definitions
description: Query the commissioned automation composition
definitions, returning the automation composition details
operationId: queryCompositionDefinitions
parameters:
- name: name
in: query
description: Automation composition definition name. Regular expressions are supported for filtering. If
this parameter is not specified, all automation composition definitions are returned.
schema:
type: string
- name: version
in: query
description: Automation composition definition version. Regular expressions are supported for filtering. If this
parameter is not specified, all automation composition definitions that match the "name" filter are are returned.
schema:
type: string
- name: X-onap-RequestId
in: header
description: RequestID for http transaction
schema:
type: string
format: uuid
responses:
200:
description: Serialised instance of
[ToscaServiceTemplates](https://github.com/onap/policy-models/blob/master/models-tosca/src/main/java/org/onap/policy/models/tosca/authorative/concepts/ToscaServiceTemplates.java)
that contains the automation composition definitions that match the requested filters.
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/ToscaServiceTemplates'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/getAllCompositionDefinitions.json'
application/yaml:
schema:
$ref: '#/components/schemas/ToscaServiceTemplates'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/getAllCompositionDefinitions.yaml'
401:
description: Authentication Error, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
security:
- basicAuth: []
x-interface info:
api-version: 1.0.0
last-mod-release: London
post:
tags:
- Automation Composition Definition
summary: Commissions automation composition definitions
description: Commissions automation composition definitions, returning the UUIDs of
automation composition definitions commissioned by this request.
operationId: createCompositionDefinitions
parameters:
- name: X-onap-RequestId
in: header
description: RequestID for http transaction
schema:
type: string
format: uuid
requestBody:
description: Serialised instance of
[ToscaServiceTemplate](https://github.com/onap/policy-models/blob/master/models-tosca/src/main/java/org/onap/policy/models/tosca/authorative/concepts/ToscaServiceTemplate.java)
containing the automation composition definitions to be commissioned.
content:
application/json:
schema:
$ref: '#/components/schemas/ToscaServiceTemplate'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/postCompositionDefinitions.json'
application/yaml:
schema:
$ref: '#/components/schemas/ToscaServiceTemplate'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/postCompositionDefinitions.yaml'
required: true
responses:
201:
description: Serialised instance of
[CommissioningResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/commissioning/CommissioningResponse.java)
containing the UUIDs of automation composition definitions created by this request
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/CommissioningResponse'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/postCommissionCompositionDefinitionsResponse.json'
application/yaml:
schema:
$ref: '#/components/schemas/CommissioningResponse'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/postCommissionCompositionDefinitionsResponse.yaml'
401:
description: Authentication Error, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
400:
description: Bad Request, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
security:
- basicAuth: []
x-interface info:
api-version: 1.0.0
last-mod-release: London
x-codegen-request-body-name: body
/compositions/{compositionId}:
get:
tags:
- Automation Composition Definition
summary: Get details of the requested commissioned automation composition
definitions
description: Get details of the requested commissioned automation composition
definitions, returning all automation composition details
operationId: getCompositionDefinition
parameters:
- name : compositionId
in: path
description: The UUID of the automation composition definition to get
required: true
schema:
type: string
format: uuid
- name: X-onap-RequestId
in: header
description: RequestID for http transaction
schema:
type: string
format: uuid
responses:
200:
description:
Serialised instance of
[ToscaServiceTemplate](https://github.com/onap/policy-models/blob/master/models-tosca/src/main/java/org/onap/policy/models/tosca/authorative/concepts/ToscaServiceTemplate.java)
containing the requested automation composition definition.
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/ToscaServiceTemplate'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/getSingleCompositionDefinition.json'
application/yaml:
schema:
$ref: '#/components/schemas/ToscaServiceTemplate'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/getSingleCompositionDefinition.yaml'
401:
description: Authentication Error, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
404:
description: Specified automation composition definition not found, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
security:
- basicAuth: []
x-interface info:
api-version: 1.0.0
last-mod-release: London
put:
tags:
- Automation Composition Definition
summary: Update an automation composition definition
description: Updates an automation composition definition as described in the supplied automation composition defintion, returning the UUID of the automation composition definition updated by this request
operationId: updateCompositionDefinition
parameters:
- name : compositionId
in: path
description: The UUID of the automation composition definition to update
required: true
schema:
type: string
format: uuid
- name: X-onap-RequestId
in: header
description: RequestID for http transaction
schema:
type: string
format: uuid
requestBody:
description: Serialised instance of
[ToscaServiceTemplate](https://github.com/onap/policy-models/blob/master/models-tosca/src/main/java/org/onap/policy/models/tosca/authorative/concepts/ToscaServiceTemplate.java)
containing the changes to be made to the automation composition definition.
content:
application/json:
schema:
$ref: '#/components/schemas/ToscaServiceTemplate'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/putCompositionDefinitionUpdate.json'
application/yaml:
schema:
$ref: '#/components/schemas/ToscaServiceTemplate'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/putCompositionDefinitionUpdate.yaml'
required: true
responses:
200:
description: Serialised instance of
[CommissioningResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/commissioning/CommissioningResponse.java)
containing the UUID of the automation composition updated by this request
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/CommissioningResponse'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/putCompositionDefinitionUpdateResponse.json'
application/yaml:
schema:
$ref: '#/components/schemas/CommissioningResponse'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/putCompositionDefinitionUpdateResponse.yaml'
401:
description: Authentication Error, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
404:
description: Specified automation composition definition not found, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
400:
description: Bad Request, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
security:
- basicAuth: []
x-interface info:
api-version: 1.0.0
last-mod-release: London
x-codegen-request-body-name: body
delete:
tags:
- Automation Composition Definition
summary: Delete a commissioned automation composition definition
description: Deletes a commissioned automation composition definition,returning the UUID of the automation composition definition deleted by this request
operationId: deleteCompositionDefinition
parameters:
- name : compositionId
in: path
description: The UUID of the automation composition definition to delete
required: true
schema:
type: string
format: uuid
- name: X-onap-RequestId
in: header
description: RequestID for http transaction
schema:
type: string
format: uuid
responses:
200:
description: Serialised instance of
[CommissioningResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/commissioning/CommissioningResponse.java)
containing the UUID of the automation composition deleted by this request
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/CommissioningResponse'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/deleteCompositionDefinitionResponse.json'
application/yaml:
schema:
$ref: '#/components/schemas/CommissioningResponse'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/deleteCompositionDefinitionResponse.yaml'
401:
description: Authentication Error, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
404:
description: Specified automation composition definition not found, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
400:
description: Bad Request, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
security:
- basicAuth: []
x-interface info:
api-version: 1.0.0
last-mod-release: London
/compositions/{compositionId}/instances:
get:
tags:
- Automation Composition Instance
summary: Query details of the requested automation composition instances
description: Query details of the requested automation composition instances for the given automation composition definition ID, returning
details of all its automation composition instances
operationId: queryCompositionInstances
parameters:
- name : compositionId
in: path
description: The UUID of the automation composition definition for which to return instances
required: true
schema:
type: string
format: uuid
- name: name
in: query
description: Automation composition instance name. Regular expressions are supported for filtering. If
this parameter is not specified, all automation composition instances for the specified definition are returned.
schema:
type: string
- name: version
in: query
description: Automation composition instance version. Regular expressions are supported for filtering. If this
parameter is not specified, all automation composition instances for the specified definition that match the "name" filter are are returned.
schema:
type: string
- name: X-onap-RequestId
in: header
description: RequestID for http transaction
schema:
type: string
format: uuid
responses:
200:
description: Serialised instance of
[AutomationCompositions](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/concepts/AutomationCompositions.java)
containing a list of automation composition instances found
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/AutomationCompositions'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/getCompositionInstancesResponse.json'
application/yaml:
schema:
$ref: '#/components/schemas/AutomationCompositions'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/getCompositionInstancesResponse.yaml'
401:
description: Authentication Error, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
404:
description: The specified automation composition definition was not found, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
security:
- basicAuth: []
x-interface info:
api-version: 1.0.0
last-mod-release: London
post:
tags:
- Automation Composition Instance
summary: Create automation composition instances
description: Creates automation composition instances that use the sepcified automation composition definition. The IDs of the created
automation composition instances are returned.
operationId: createCompositionInstances
parameters:
- name : compositionId
in: path
description: The UUID of the automation composition definition on which to create instances
required: true
schema:
type: string
format: uuid
- name: X-onap-RequestId
in: header
description: RequestID for http transaction
schema:
type: string
format: uuid
requestBody:
description: Serialised instance of
[AutomationCompositions](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/concepts/AutomationCompositions.java)
containing a list of automation composition instances to create
content:
application/json:
schema:
$ref: '#/components/schemas/AutomationCompositions'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/postCompositionInstances.json'
application/yaml:
schema:
$ref: '#/components/schemas/AutomationCompositions'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/postCompositionInstances.yaml'
required: true
responses:
201:
description: Serialised instance of
[InstantiationResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/instantiation/InstantiationResponse.java)
containing the UUIDs of the created automation composition instances
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/InstantiationResponse'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/postCompositionInstancesResponse.json'
application/yaml:
schema:
$ref: '#/components/schemas/InstantiationResponse'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/postCompositionInstancesResponse.yaml'
401:
description: Authentication Error, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
404:
description: The specified automation composition definition was not found, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
400:
description: Bad Request, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
security:
- basicAuth: []
x-interface info:
api-version: 1.0.0
last-mod-release: London
x-codegen-request-body-name: body
/compositions/{compositionId}/instances/{instanceId}:
get:
tags:
- Automation Composition Instance
summary: Get automation composition instance details.
description: Get details of the requested automation composition instance.
operationId: getCompositionInstance
parameters:
- name : compositionId
in: path
description: The UUID of the automation composition definition on which to get an instance
required: true
schema:
type: string
format: uuid
- name : instanceId
in: path
description: The UUID of the automation composition instance to get
required: true
schema:
type: string
format: uuid
- name: X-onap-RequestId
in: header
description: RequestID for http transaction
schema:
type: string
format: uuid
responses:
200:
description: Serialised instance of
[AutomationCompositions](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/concepts/AutomationCompositions.java)
containing a list of automation composition instances with one entry
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/AutomationCompositions'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/getCompositionInstanceResponse.json'
application/yaml:
schema:
$ref: '#/components/schemas/AutomationCompositions'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/getCompositionInstanceResponse.yaml'
401:
description: Authentication Error, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
404:
description: The automation composition instance was not found, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
security:
- basicAuth: []
x-interface info:
api-version: 1.0.0
last-mod-release: London
put:
tags:
- Automation Composition Instance
summary: Update an automation composition instance
description: This request updates an automation composition instance. It may update instance properties or change the state of the automation composition instance
operationId: updateCompositionInstance
parameters:
- name : compositionId
in: path
description: The UUID of the automation composition definition on which to update an instance
required: true
schema:
type: string
format: uuid
- name : instanceId
in: path
description: The UUID of the automation composition instance to update
required: true
schema:
type: string
format: uuid
- name: X-onap-RequestId
in: header
description: RequestID for http transaction
schema:
type: string
format: uuid
requestBody:
description: Serialised instance of
[InstantiationUpdate](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/instantiation/InstantiationUpdate.java)
which specifies the update operation to be carried out on the automation concept instance
content:
application/json:
schema:
title: InstantiationUpdate
type: object
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/putCompositionInstanceUpdate.json'
application/yaml:
schema:
title: InstantiationUpdate
type: object
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/putCompositionInstanceUpdate.yaml'
required: true
responses:
200:
description: Serialised instance of
[InstantiationResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/instantiation/InstantiationResponse.java)
containing the UUID of the updated automation composition instance
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/InstantiationResponse'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/putCompositionInstanceUpdateResponse.json'
application/yaml:
schema:
$ref: '#/components/schemas/InstantiationResponse'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/putCompositionInstanceUpdateResponse.yaml'
401:
description: Authentication Error, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
404:
description: The specified automation composition instance was not found, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
400:
description: Bad Request, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
security:
- basicAuth: []
x-interface info:
api-version: 1.0.0
last-mod-release: London
x-codegen-request-body-name: body
delete:
tags:
- Automation Composition Instance
summary: Delete an automation composition instance
description: Deletes a automation composition instance, returning the UUID of the deleted automation composition instance
operationId: deleteCompositionInstance
parameters:
- name : compositionId
in: path
description: The UUID of the automation composition definition on which to delete an instance
required: true
schema:
type: string
format: uuid
- name : instanceId
in: path
description: The UUID of the automation composition instance to delete
required: true
schema:
type: string
format: uuid
- name: X-onap-RequestId
in: header
description: RequestID for http transaction
schema:
type: string
format: uuid
responses:
200:
description: Serialised instance of
[InstantiationResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/instantiation/InstantiationResponse.java)
containing the UUID of the deleted automation composition instance
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/InstantiationResponse'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/deleteCompositionInstanceResponse.json'
application/yaml:
schema:
$ref: '#/components/schemas/InstantiationResponse'
example:
externalValue: 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/examples/deleteCompositionInstanceResponse.yaml'
401:
description: Authentication Error, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
404:
description: The specified automation composition instance was not found, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
400:
description: Bad Request, returns an instance of
[SimpleResponse](https://github.com/onap/policy-clamp/blob/master/models/src/main/java/org/onap/policy/clamp/models/acm/messages/rest/SimpleResponse.java)
headers:
X-LatestVersion:
schema:
type: string
X-PatchVersion:
schema:
type: string
X-MinorVersion:
schema:
type: string
X-onap-RequestId:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleResponse'
security:
- basicAuth: []
x-interface info:
api-version: 1.0.0
last-mod-release: London
components:
securitySchemes:
basicAuth:
type: http
scheme: basic
schemas:
ToscaServiceTemplates:
title: ToscaServiceTemplates
type: object
ToscaServiceTemplate:
title: ToscaServiceTemplate
type: object
AutomationCompositions:
title: AutomationCompositions
type: object
SimpleResponse:
title: SimpleResponse
type: object
CommissioningResponse:
title: CommissioningResponse
type: object
InstantiationResponse:
title: InstantiationResponse
type: object