Fortinet black logo

Administration Guide

Get a list of FortiFlex configurations

Get a list of FortiFlex configurations

Use the fortiflexvm_configs_list_info module to get a list of configurations from the FortiFlex API using the provided credentials and program serial number.

Parameters

The following parameters are included:

Parameter

Type

Description

username

String (Optional)

The username to authenticate. If not declared, the code will read the environment variable FLEXVM_ACCESS_USERNAME.

password

String (Optional)

The password to authenticate. If not declared, the code will read the environment variable FLEXVM_ACCESS_PASSWORD.

programSerialNumber

String

The serial number of the program to get configurations for.

Example

The following is an example use of this module:

- name: Get list of Flex VM Configurations for a Program
  hosts: localhost
  collections:
    - fortinet.fortiflexvm
  vars:
    username: "<your_own_value>"
    password: "<your_own_value>"
  tasks:
    - name:  Get configs list
      fortinet.fortiflexvm.fortiflexvm_configs_list_info:
        username: "{{ username }}"
        password: "{{ password }}"
        programSerialNumber: "ELAVMS000000XXXX"
      register: result

    - name: Display response
      debug:
        var: result.configs

Return values

The following parameters are returned:

Parameter

Type Returned

Description

configs

Dictionary

The list of configurations for the specified program.

The configs dictionary includes:

Parameter

Type Returned

Description

id

Integer

The ID of the configuration.

name

String

The name of the configuration.

programSerialNumber

String

The program serial number the configuration belongs to.

status

String

The status of the configuration.

fortigateBundle

Dictionary (Changed)

The FortiGate Virtual Machine - Service Bundle.

fortiManager

Dictionary (Changed)

The FortiManager Virtual Machine.

fortiWeb

Dictionary (Changed)

The FortiWeb Virtual Machine - Service Bundle.

fortiGateLCS

Dictionary (Changed)

The FortiGate Virtual Machine - A La Carte Services.

fortiAnalyzer

Dictionary (Changed)

The FortiAnalyzer Virtual Machine.

fortiPortal

Dictionary (Changed)

The FortiPortal Virtual Machine.

The fortigateBundle dictionary includes:

Attribute

Type

Description

cpu

String

The number of CPUs. This value can be "1", "2", "4", "8", "16", "32", or "2147483647" (unlimited).

service

String

The value can be either "FC" (FortiCare), "UTM", "ENT" (Enterprise), or "ATP".

vdom

Integer

The number of VDOMs between 0 and 500. The default value is 0.

The fortiManager dictionary includes:

Attribute

Type

Description

device

Integer

The number of managed devices between 1 and 100000.

adom

Integer

The number of ADOMs between 1 and 100000.

The fortiWeb dictionary includes:

Attribute

Type

Description

cpu

String

The number of CPUs. This value can be "1", "2", "4", "8", or "16".

service

String

The service package can be "FWBSTD" (Standard) or "FWBADV" (Advanced).

The fortiGateLCS dictionary includes:

Attribute

Type

Description

cpu

Integer

The number of CPUs between 1 and 96.

fortiGuardServices

List

The FortiGuard services this FortiGate Virtual Machine supports. The default value is an empty list but may contain "IPS", "AVDB", "FURL", "IOTH", "FGSA", and "ISSS".

supportService

String

The value can be "FC247" (FortiCare 24x7) or "ASET" (FortiCare Elite).

vdom

Integer

The number of VDOMs between 1 and 500.

cloudServices

List

The cloud services this FortiGate Virtual Machine supports. The default value is an empty list but may contain "FAMS", "SWNM", "FMGC", and "AFAC".

The fortiAnalyzer dictionary includes:

Attribute

Type

Description

storage

Integer

The daily storage (GB) between 5 and 8300.

adom

Integer

The number of ADOMs between 0 and 1200.

service

String

The support service. "FAZFC247" (FortiCare Premium) is currently the only available option and is the default.

The fortiPortal dictionary includes:

Attribute

Type

Description

device

String

The number of managed devices between 0 and 100000.

Get a list of FortiFlex configurations

Use the fortiflexvm_configs_list_info module to get a list of configurations from the FortiFlex API using the provided credentials and program serial number.

Parameters

The following parameters are included:

Parameter

Type

Description

username

String (Optional)

The username to authenticate. If not declared, the code will read the environment variable FLEXVM_ACCESS_USERNAME.

password

String (Optional)

The password to authenticate. If not declared, the code will read the environment variable FLEXVM_ACCESS_PASSWORD.

programSerialNumber

String

The serial number of the program to get configurations for.

Example

The following is an example use of this module:

- name: Get list of Flex VM Configurations for a Program
  hosts: localhost
  collections:
    - fortinet.fortiflexvm
  vars:
    username: "<your_own_value>"
    password: "<your_own_value>"
  tasks:
    - name:  Get configs list
      fortinet.fortiflexvm.fortiflexvm_configs_list_info:
        username: "{{ username }}"
        password: "{{ password }}"
        programSerialNumber: "ELAVMS000000XXXX"
      register: result

    - name: Display response
      debug:
        var: result.configs

Return values

The following parameters are returned:

Parameter

Type Returned

Description

configs

Dictionary

The list of configurations for the specified program.

The configs dictionary includes:

Parameter

Type Returned

Description

id

Integer

The ID of the configuration.

name

String

The name of the configuration.

programSerialNumber

String

The program serial number the configuration belongs to.

status

String

The status of the configuration.

fortigateBundle

Dictionary (Changed)

The FortiGate Virtual Machine - Service Bundle.

fortiManager

Dictionary (Changed)

The FortiManager Virtual Machine.

fortiWeb

Dictionary (Changed)

The FortiWeb Virtual Machine - Service Bundle.

fortiGateLCS

Dictionary (Changed)

The FortiGate Virtual Machine - A La Carte Services.

fortiAnalyzer

Dictionary (Changed)

The FortiAnalyzer Virtual Machine.

fortiPortal

Dictionary (Changed)

The FortiPortal Virtual Machine.

The fortigateBundle dictionary includes:

Attribute

Type

Description

cpu

String

The number of CPUs. This value can be "1", "2", "4", "8", "16", "32", or "2147483647" (unlimited).

service

String

The value can be either "FC" (FortiCare), "UTM", "ENT" (Enterprise), or "ATP".

vdom

Integer

The number of VDOMs between 0 and 500. The default value is 0.

The fortiManager dictionary includes:

Attribute

Type

Description

device

Integer

The number of managed devices between 1 and 100000.

adom

Integer

The number of ADOMs between 1 and 100000.

The fortiWeb dictionary includes:

Attribute

Type

Description

cpu

String

The number of CPUs. This value can be "1", "2", "4", "8", or "16".

service

String

The service package can be "FWBSTD" (Standard) or "FWBADV" (Advanced).

The fortiGateLCS dictionary includes:

Attribute

Type

Description

cpu

Integer

The number of CPUs between 1 and 96.

fortiGuardServices

List

The FortiGuard services this FortiGate Virtual Machine supports. The default value is an empty list but may contain "IPS", "AVDB", "FURL", "IOTH", "FGSA", and "ISSS".

supportService

String

The value can be "FC247" (FortiCare 24x7) or "ASET" (FortiCare Elite).

vdom

Integer

The number of VDOMs between 1 and 500.

cloudServices

List

The cloud services this FortiGate Virtual Machine supports. The default value is an empty list but may contain "FAMS", "SWNM", "FMGC", and "AFAC".

The fortiAnalyzer dictionary includes:

Attribute

Type

Description

storage

Integer

The daily storage (GB) between 5 and 8300.

adom

Integer

The number of ADOMs between 0 and 1200.

service

String

The support service. "FAZFC247" (FortiCare Premium) is currently the only available option and is the default.

The fortiPortal dictionary includes:

Attribute

Type

Description

device

String

The number of managed devices between 0 and 100000.