VNF Lcm commands

VNF LCM commands are CLI interface of VNF Lifecycle Management Interface in ETSI NFV-SOL 002 and ETSI NFV-SOL 003.

Note

Commands call version 1 vnflcm APIs by default. You can call the specific version of vnflcm APIs by using the option --os-tacker-api-version. Commands with --os-tacker-api-version 2 call version 2 vnflcm APIs. vnflcm op cancel is included in only version 1 vnflcm APIs and change-vnfpkg is included in only version 2 vnflcm APIs.

vnflcm change-ext-conn

Change External VNF Connectivity

openstack vnflcm change-ext-conn <vnf-instance> <param-file>
vnf-instance

VNF instance ID to Change External VNF Connectivity

param-file

Specify change-ext-conn request parameters in a json file.

This command is provided by the python-tackerclient plugin.

vnflcm create

Create a new VNF Instance

openstack vnflcm create
    [-f {json,shell,table,value,yaml}]
    [-c COLUMN]
    [--noindent]
    [--prefix PREFIX]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    [--name <vnf-instance-name>]
    [--description <vnf-instance-description>]
    [--I <param-file>]
    <vnfd-id>
-f <FORMATTER>, --format <FORMATTER>

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated to show multiple columns

--noindent

whether to disable indenting the JSON

--prefix <PREFIX>

add a prefix to all variable names

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

--name <vnf-instance-name>

Name of the VNF instance to be created.

--description <vnf-instance-description>

Description of the VNF instance to be created.

--I <param-file>

Instantiate VNF subsequently after it’s creation. Specify instantiate request parameters in a json file.

vnfd-id

Identifier that identifies the VNFD which defines the VNF instance to be created.

This command is provided by the python-tackerclient plugin.

vnflcm delete

Delete VNF Instance(s)

openstack vnflcm delete <vnf-instance> [<vnf-instance> ...]
vnf-instance

VNF instance ID(s) to delete

This command is provided by the python-tackerclient plugin.

vnflcm heal

Heal VNF Instance

openstack vnflcm heal
    [--cause CAUSE]
    [--vnfc-instance <vnfc-instance-id> [<vnfc-instance-id> ...]]
    [--additional-param-file <additional-param-file>]
    <vnf-instance>
--cause <CAUSE>

Specify the reason why a healing procedure is required.

--vnfc-instance <vnfc-instance-id>

List of VNFC instances requiring a healing action.

--additional-param-file <additional-param-file>

Additional parameters passed by the NFVO as input to the healing process.

vnf-instance

VNF instance ID to heal

This command is provided by the python-tackerclient plugin.

vnflcm instantiate

Instantiate a VNF Instance

openstack vnflcm instantiate <vnf-instance> <param-file>
vnf-instance

VNF instance ID to instantiate

param-file

Specify instantiate request parameters in a json file.

This command is provided by the python-tackerclient plugin.

vnflcm list

List VNF Instance

openstack vnflcm list
    [-f {csv,json,table,value,yaml}]
    [-c COLUMN]
    [--quote {all,minimal,none,nonnumeric}]
    [--noindent]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
-f <FORMATTER>, --format <FORMATTER>

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated to show multiple columns

--quote <QUOTE_MODE>

when to include quotes, defaults to nonnumeric

--noindent

whether to disable indenting the JSON

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

This command is provided by the python-tackerclient plugin.

vnflcm op cancel

Cancel VNF Instance

openstack vnflcm op cancel
    [-f {json,shell,table,value,yaml}]
    [-c COLUMN]
    [--noindent]
    [--prefix PREFIX]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    [--cancel-mode <cancel-mode>]
    <vnf-lcm-op-occ-id>
-f <FORMATTER>, --format <FORMATTER>

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated to show multiple columns

--noindent

whether to disable indenting the JSON

--prefix <PREFIX>

add a prefix to all variable names

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

--cancel-mode <cancel-mode>

Cancel mode can be ‘GRACEFUL’ or ‘FORCEFUL’. Default is ‘GRACEFUL’

vnf-lcm-op-occ-id

VNF lifecycle management operation occurrence ID.

This command is provided by the python-tackerclient plugin.

vnflcm op fail

Fail VNF Instance

openstack vnflcm op fail
    [-f {json,shell,table,value,yaml}]
    [-c COLUMN]
    [--noindent]
    [--prefix PREFIX]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    <vnf-lcm-op-occ-id>
-f <FORMATTER>, --format <FORMATTER>

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated to show multiple columns

--noindent

whether to disable indenting the JSON

--prefix <PREFIX>

add a prefix to all variable names

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

vnf-lcm-op-occ-id

VNF lifecycle management operation occurrence ID.

This command is provided by the python-tackerclient plugin.

vnflcm op list

List LCM Operation Occurrences

openstack vnflcm op list
    [-f {csv,json,table,value,yaml}]
    [-c COLUMN]
    [--quote {all,minimal,none,nonnumeric}]
    [--noindent]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--filter <filter>]
    [--fields <fields> | --exclude-fields <exclude-fields>]
-f <FORMATTER>, --format <FORMATTER>

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated to show multiple columns

--quote <QUOTE_MODE>

when to include quotes, defaults to nonnumeric

--noindent

whether to disable indenting the JSON

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--filter <filter>

Attribute-based-filtering parameters

--fields <fields>

Complex attributes to be included into the response

--exclude-fields <exclude-fields>

Complex attributes to be excluded from the response

This command is provided by the python-tackerclient plugin.

vnflcm op retry

Retry VNF Instance

openstack vnflcm op retry <vnf-lcm-op-occ-id>
vnf-lcm-op-occ-id

VNF lifecycle management operation occurrence ID.

This command is provided by the python-tackerclient plugin.

vnflcm op rollback

openstack vnflcm op rollback <vnf-lcm-op-occ-id>
vnf-lcm-op-occ-id

VNF lifecycle management operation occurrence ID.

This command is provided by the python-tackerclient plugin.

vnflcm op show

Display Operation Occurrence details

openstack vnflcm op show
    [-f {json,shell,table,value,yaml}]
    [-c COLUMN]
    [--noindent]
    [--prefix PREFIX]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    <vnf-lcm-op-occ-id>
-f <FORMATTER>, --format <FORMATTER>

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated to show multiple columns

--noindent

whether to disable indenting the JSON

--prefix <PREFIX>

add a prefix to all variable names

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

vnf-lcm-op-occ-id

VNF lifecycle management operation occurrence ID.

This command is provided by the python-tackerclient plugin.

vnflcm scale

Scale a VNF Instance

openstack vnflcm scale
    [--number-of-steps <number-of-steps>]
    [--additional-param-file <additional-param-file>]
    --type <type>
    --aspect-id <aspect-id>
    <vnf-instance>
--number-of-steps <number-of-steps>

Number of scaling steps to be executed as part of this Scale VNF operation.

--additional-param-file <additional-param-file>

Additional parameters passed by the NFVO as input to the scaling process.

--type <type>

SCALE_OUT or SCALE_IN for type of scale operation.

--aspect-id <aspect-id>

Identifier of the scaling aspect.

vnf-instance

VNF instance ID to scale

This command is provided by the python-tackerclient plugin.

vnflcm show

Display VNF instance details

openstack vnflcm show
    [-f {json,shell,table,value,yaml}]
    [-c COLUMN]
    [--noindent]
    [--prefix PREFIX]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    <vnf-instance>
-f <FORMATTER>, --format <FORMATTER>

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated to show multiple columns

--noindent

whether to disable indenting the JSON

--prefix <PREFIX>

add a prefix to all variable names

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

vnf-instance

VNF instance ID to display

This command is provided by the python-tackerclient plugin.

vnflcm subsc create

Create a new Lccn Subscription

openstack vnflcm subsc create
    [-f {json,shell,table,value,yaml}]
    [-c COLUMN]
    [--noindent]
    [--prefix PREFIX]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    <param-file>
-f <FORMATTER>, --format <FORMATTER>

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated to show multiple columns

--noindent

whether to disable indenting the JSON

--prefix <PREFIX>

add a prefix to all variable names

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

param-file

Specify create request parameters in a json file.

This command is provided by the python-tackerclient plugin.

vnflcm subsc delete

Delete Lccn Subscription(s)

openstack vnflcm subsc delete <subscription-id> [<subscription-id> ...]
subscription-id

Lccn Subscription ID(s) to delete

This command is provided by the python-tackerclient plugin.

vnflcm subsc list

List Lccn Subscriptions

openstack vnflcm subsc list
    [-f {csv,json,table,value,yaml}]
    [-c COLUMN]
    [--quote {all,minimal,none,nonnumeric}]
    [--noindent]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--filter <filter>]
-f <FORMATTER>, --format <FORMATTER>

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated to show multiple columns

--quote <QUOTE_MODE>

when to include quotes, defaults to nonnumeric

--noindent

whether to disable indenting the JSON

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--filter <filter>

Attribute-based-filtering parameters

This command is provided by the python-tackerclient plugin.

vnflcm subsc show

Display Lccn Subscription details

openstack vnflcm subsc show
    [-f {json,shell,table,value,yaml}]
    [-c COLUMN]
    [--noindent]
    [--prefix PREFIX]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    <subscription-id>
-f <FORMATTER>, --format <FORMATTER>

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated to show multiple columns

--noindent

whether to disable indenting the JSON

--prefix <PREFIX>

add a prefix to all variable names

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

subscription-id

Lccn Subscription ID to display

This command is provided by the python-tackerclient plugin.

vnflcm terminate

Terminate a VNF instance

openstack vnflcm terminate
    [--termination-type <termination-type>]
    [--graceful-termination-timeout <graceful-termination-timeout>]
    [--D]
    <vnf-instance>
--termination-type <termination-type>

Termination type can be ‘GRACEFUL’ or ‘FORCEFUL’. Default is ‘GRACEFUL’

--graceful-termination-timeout <graceful-termination-timeout>

This attribute is only applicable in case of graceful termination. It defines the time to wait for the VNF to be taken out of service before shutting down the VNF and releasing the resources. The unit is seconds.

--D

Delete VNF Instance subsequently after it’s termination

vnf-instance

VNF instance ID to terminate

This command is provided by the python-tackerclient plugin.

vnflcm update

Update VNF Instance

openstack vnflcm update [--I <param-file>] <vnf-instance>
--I <param-file>

Specify update request parameters in a json file.

vnf-instance

VNF instance ID to update.

This command is provided by the python-tackerclient plugin.

vnflcm versions

Show VnfLcm Api versions

openstack vnflcm versions
    [-f {json,shell,table,value,yaml}]
    [-c COLUMN]
    [--noindent]
    [--prefix PREFIX]
    [--max-width <integer>]
    [--fit-width]
    [--print-empty]
    [--major-version <major-version>]
-f <FORMATTER>, --format <FORMATTER>

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated to show multiple columns

--noindent

whether to disable indenting the JSON

--prefix <PREFIX>

add a prefix to all variable names

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

--major-version <major-version>

Show only specify major version.

This command is provided by the python-tackerclient plugin.

vnflcm change-vnfpkg

Change Current VNF Package

openstack vnflcm change-vnfpkg <vnf-instance> <param-file>
vnf-instance

VNF instance ID to Change Current VNF Package

param-file

Specify change-vnfpkg request parameters in a json file.

This command is provided by the python-tackerclient plugin.