Fortinet black logo

Administration Guide

Update a FortiFlex configuration

Update a FortiFlex configuration

Use the fortiflexvm_configs_update module to update a 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.

id

Integer

The ID of the configuration you want to update.

name

String (Optional)

The name of your FortiFlex configuration.

status

String (Optional)

The status of the configuration, either ACTIVE or DISABLED.

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: Update VM configuration
  hosts: localhost
  collections:
    - fortinet.fortiflexvm
  vars:
    username: "<your_own_value>"
    password: "<your_own_value>"
  tasks:
    - name: Update a Virtual Machine configuration
      fortinet.fortiflexvm.fortiflexvm_configs_update:
        username: "{{ username }}"
        password: "{{ password }}"
        id: 3643
        name: "ansible_modify"
        status: "DISABLED" # ACTIVE or DISABLED

        # Please only use zero or one of the following.
        # If you want to update the configuration, please use the type you declared in fortiflexvm_configs_create.

        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 update.

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.

Update a FortiFlex configuration

Use the fortiflexvm_configs_update module to update a 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.

id

Integer

The ID of the configuration you want to update.

name

String (Optional)

The name of your FortiFlex configuration.

status

String (Optional)

The status of the configuration, either ACTIVE or DISABLED.

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: Update VM configuration
  hosts: localhost
  collections:
    - fortinet.fortiflexvm
  vars:
    username: "<your_own_value>"
    password: "<your_own_value>"
  tasks:
    - name: Update a Virtual Machine configuration
      fortinet.fortiflexvm.fortiflexvm_configs_update:
        username: "{{ username }}"
        password: "{{ password }}"
        id: 3643
        name: "ansible_modify"
        status: "DISABLED" # ACTIVE or DISABLED

        # Please only use zero or one of the following.
        # If you want to update the configuration, please use the type you declared in fortiflexvm_configs_create.

        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 update.

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.