From fec1b41ae4aa6c88ad4f42306b9b491c655fdbc7 Mon Sep 17 00:00:00 2001 From: Taka Cho Date: Mon, 16 Mar 2020 14:32:31 -0400 Subject: [PATCH] add ConfigScaleIn in LCM API Doc add ConfigScaleIn in LCM API Doc Issue-ID: APPC-1852 Change-Id: If2e714d14bd4e32af18b9da148b293a45c0584d3 Signed-off-by: Taka Cho --- docs/APPC LCM API Guide/APPC LCM API Guide.rst | 59 ++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) diff --git a/docs/APPC LCM API Guide/APPC LCM API Guide.rst b/docs/APPC LCM API Guide/APPC LCM API Guide.rst index 8ea060030..e35b7c9ea 100644 --- a/docs/APPC LCM API Guide/APPC LCM API Guide.rst +++ b/docs/APPC LCM API Guide/APPC LCM API Guide.rst @@ -570,6 +570,8 @@ Commands, or actions, may be currently supported on all VNF types or a limited s +-----------------------------+-----------+------------------+----------------+----------+------------------------------------------------------------+ | ConfigRestore | Yes | | | | Chef and Ansible only (requires self-service onboarding) | +-----------------------------+-----------+------------------+----------------+----------+------------------------------------------------------------+ +| ConfigScaleIn | Yes | | Yes | Yes | Chef and Ansible only (requires self-service onboarding) | ++-----------------------------+-----------+------------------+----------------+----------+------------------------------------------------------------+ | ConfigScaleOut | Yes | | | | Any (requires self-service onboarding) | +-----------------------------+-----------+------------------+----------------+----------+------------------------------------------------------------+ | DetachVolume | | | | Yes | Any (uses OpenStack command) | @@ -1194,6 +1196,63 @@ If successful, the return payload contains the ‘upload_config_id’ and values **Failure:** A failed ConfigRestore returns a failure code 401 and the failure message. +ConfigScaleIn +------------- + +The ConfigScaleIn command is used to apply any actions on a VNF as part of a ScaleIn flow. Actions could include updating the VNF configuration or running a set of other tasks. + +The ConfigScaleIn action can have multiple APPC templates associated with it. APPC retrieves the VfModuleModelName from A&AI (model.model-vers.model-name), which is used as the unique identifier to select the correct APPC template. +APPC creates or updates VNFC records in A&AI for the newly instantiated VM’s. The orchestration-status of the VNFC’s is set to CONFIGURED. + +This action is supported via the Netconf (limited to configuration changes), Chef, and Ansible protocols. + +| + ++------------------------------+------------------------------------------------------------------------------------------+ +| **Target URL** | /restconf /operations/appc-provider-lcm:config-scale-in | ++------------------------------+------------------------------------------------------------------------------------------+ +| **Action** | ConfigScaleIn | ++------------------------------+------------------------------------------------------------------------------------------+ +| **Action-Identifiers** | Vnf-id | ++------------------------------+------------------------------------------------------------------------------------------+ +| **Payload Parameters** | See below | ++------------------------------+------------------------------------------------------------------------------------------+ +| **Revision History** | New in Frankfurt | ++------------------------------+------------------------------------------------------------------------------------------+ + +| + ++---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------+---------------------------------------------+ +| **Payload Parameter** | **Description** | **Required?** | **Example** | ++=================================+==================================================================================================================================================================+=====================+=============================================+ +| request-parameters | vnf-host-ip-address: optional if Netconf or other direct interface to the VNF. If not provided, the vnf-host-ip-address will be obtained from A&AI. | No | "payload": | +| +------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------+ "{\\"request-parameters \\": | +| | vf-module-id: used to determine the A&AI VM inventory associated with ConfigScaleIn. | Yes | { | +| +------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------+ \\"vnf-host-ip-address\\": | +| | controller-template-id: optional. This is a unique identifier that will identify the template associated with the ConfigScaleIn. | | \\”value\\”, | +| | Will be needed if A&AI does not contain the template identifier. | No | \\”vf-module-id\\”: \\”value\\”, | ++---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------+ \\”controller-template-id\\”: | +| configuration-parameters | A set of instance specific configuration parameters should be specified. If provided, APP-C replaces variables in the configuration template with the | No | \\”value\\” | +| | values supplied. | | } | +| | | | | +| | | | \\"configuration-parameters\\": | +| | | | {\\"\\"} | +| | | | | ++---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------+---------------------------------------------+ + +ConfigScaleIn Response +^^^^^^^^^^^^^^^^^^^^^^ + +**Success:** + + - A successful ConfigScaleIn returns a success status code 400 when completed. + +**Failure:** + + - A failed ConfigScaleIn returns a failure code 401 and the failure message. + - If the ConfigScaleIn is successfully performed on the VNF but there is a failure to update A&AI inventory, an intermediate failure message with failure code 501 is returned prior to the final 400 success message. + + ConfigScaleOut -------------- -- 2.16.6