Fortinet black logo

Administration Guide

Create a new FortiFlex configuration

Create a new FortiFlex configuration

Use the fortflexvm_configs_create module to create a new FortiFlex configuration under a program.

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 your FortiFlex program.

name

String

The name of your FortiFlex configuration.

fortigateBundle

Dictionary (Optional)

The FortiGate Virtual Machine - Service Bundle.

fortiManager

Dictionary (Optional)

The FortiManager Virtual Machine.

fortiWeb

Dictionary (Optional)

The FortiWeb Virtual Machine - Service Bundle.

fortiGateLCS

Dictionary (Optional)

The FortiGate Virtual Machine - A La Carte Services.

fortiAnalyzer

Dictionary (Optional)

The FortiAnalyzer Virtual Machine.

fortiPortal

Dictionary (Optional)

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 (Optional)

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 (Optional)

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 (Optional)

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

Integer

The number of managed devices between 0 and 100000.

Example

The following is an example use of this module:

- name: Create VM configuration
  hosts: localhost
  collections:
    - fortinet.fortiflexvm
  vars:
    username: "<your_own_value>"
    password: "<your_own_value>"
  tasks:
    - name: Create a Virtual Machine configuration
      fortinet.fortiflexvm.fortiflexvm_configs_create:
        username: "{{ username }}"
        password: "{{ password }}"
        programSerialNumber: "ELAVMS000000XXXX"
        name: "ansible"

        # Please only use one of the following.

        fortiGateBundle:
          cpu: "2" # "1", "2", "4", "8", "16", "32", "2147483647"
          service: "FC" # "FC", "UTM", "ENT", "ATP"
          vdom: 10 # 0 ~ 500

        # fortiManager:
        #   device: 1 # 1 ~ 100000
        #   adom: 1 # 1 ~ 100000

        # fortiWeb:
        #   cpu: "4" # "1", "2", "4", "8", "16"
        #   service: "FWBSTD" # "FWBSTD" or "FWBADV"

        # fortiGateLCS:
        #   cpu: 4 # 1 ~ 96
        #   fortiGuardServices: [] # "IPS", "AVDB", "FURL", "IOTH", "FGSA", "ISSS"
        #   supportService: "FC247" # "FC247", "ASET"
        #   vdom: 1 # 1 ~ 500
        #   cloudServices: ["FAMS", "SWNM"] # "FAMS", "SWNM", "FMGC", "AFAC"

        # fortiAnalyzer:
        #   storage: 5 # 5 ~ 8300
        #   adom: 1 # 0 ~ 1200
        #   service: "FAZFC247" # "FAZFC247"

        # fortiPortal:
        #   device: 1 # 0 ~ 100000

      register: result

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

Return values

The following parameters are returned:

Parameter

Type Returned

Description

configs

Dictionary

The configuration you create.

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.

See the Parameters for dictionary attributes that are always returned.

Create a new FortiFlex configuration

Use the fortflexvm_configs_create module to create a new FortiFlex configuration under a program.

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 your FortiFlex program.

name

String

The name of your FortiFlex configuration.

fortigateBundle

Dictionary (Optional)

The FortiGate Virtual Machine - Service Bundle.

fortiManager

Dictionary (Optional)

The FortiManager Virtual Machine.

fortiWeb

Dictionary (Optional)

The FortiWeb Virtual Machine - Service Bundle.

fortiGateLCS

Dictionary (Optional)

The FortiGate Virtual Machine - A La Carte Services.

fortiAnalyzer

Dictionary (Optional)

The FortiAnalyzer Virtual Machine.

fortiPortal

Dictionary (Optional)

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 (Optional)

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 (Optional)

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 (Optional)

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

Integer

The number of managed devices between 0 and 100000.

Example

The following is an example use of this module:

- name: Create VM configuration
  hosts: localhost
  collections:
    - fortinet.fortiflexvm
  vars:
    username: "<your_own_value>"
    password: "<your_own_value>"
  tasks:
    - name: Create a Virtual Machine configuration
      fortinet.fortiflexvm.fortiflexvm_configs_create:
        username: "{{ username }}"
        password: "{{ password }}"
        programSerialNumber: "ELAVMS000000XXXX"
        name: "ansible"

        # Please only use one of the following.

        fortiGateBundle:
          cpu: "2" # "1", "2", "4", "8", "16", "32", "2147483647"
          service: "FC" # "FC", "UTM", "ENT", "ATP"
          vdom: 10 # 0 ~ 500

        # fortiManager:
        #   device: 1 # 1 ~ 100000
        #   adom: 1 # 1 ~ 100000

        # fortiWeb:
        #   cpu: "4" # "1", "2", "4", "8", "16"
        #   service: "FWBSTD" # "FWBSTD" or "FWBADV"

        # fortiGateLCS:
        #   cpu: 4 # 1 ~ 96
        #   fortiGuardServices: [] # "IPS", "AVDB", "FURL", "IOTH", "FGSA", "ISSS"
        #   supportService: "FC247" # "FC247", "ASET"
        #   vdom: 1 # 1 ~ 500
        #   cloudServices: ["FAMS", "SWNM"] # "FAMS", "SWNM", "FMGC", "AFAC"

        # fortiAnalyzer:
        #   storage: 5 # 5 ~ 8300
        #   adom: 1 # 0 ~ 1200
        #   service: "FAZFC247" # "FAZFC247"

        # fortiPortal:
        #   device: 1 # 0 ~ 100000

      register: result

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

Return values

The following parameters are returned:

Parameter

Type Returned

Description

configs

Dictionary

The configuration you create.

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.

See the Parameters for dictionary attributes that are always returned.