1. Packages
  2. Fortios
  3. API Docs
  4. switchcontroller
  5. Global
Fortios v0.0.6 published on Tuesday, Jul 9, 2024 by pulumiverse

fortios.switchcontroller.Global

Explore with Pulumi AI

Configure FortiSwitch global settings.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as fortios from "@pulumiverse/fortios";

const trname = new fortios.switchcontroller.Global("trname", {
    allowMultipleInterfaces: "disable",
    httpsImagePush: "disable",
    logMacLimitViolations: "disable",
    macAgingInterval: 332,
    macRetentionPeriod: 24,
    macViolationTimer: 0,
});
Copy
import pulumi
import pulumiverse_fortios as fortios

trname = fortios.switchcontroller.Global("trname",
    allow_multiple_interfaces="disable",
    https_image_push="disable",
    log_mac_limit_violations="disable",
    mac_aging_interval=332,
    mac_retention_period=24,
    mac_violation_timer=0)
Copy
package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-fortios/sdk/go/fortios/switchcontroller"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := switchcontroller.NewGlobal(ctx, "trname", &switchcontroller.GlobalArgs{
			AllowMultipleInterfaces: pulumi.String("disable"),
			HttpsImagePush:          pulumi.String("disable"),
			LogMacLimitViolations:   pulumi.String("disable"),
			MacAgingInterval:        pulumi.Int(332),
			MacRetentionPeriod:      pulumi.Int(24),
			MacViolationTimer:       pulumi.Int(0),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Fortios = Pulumiverse.Fortios;

return await Deployment.RunAsync(() => 
{
    var trname = new Fortios.Switchcontroller.Global("trname", new()
    {
        AllowMultipleInterfaces = "disable",
        HttpsImagePush = "disable",
        LogMacLimitViolations = "disable",
        MacAgingInterval = 332,
        MacRetentionPeriod = 24,
        MacViolationTimer = 0,
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.fortios.switchcontroller.Global;
import com.pulumi.fortios.switchcontroller.GlobalArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var trname = new Global("trname", GlobalArgs.builder()
            .allowMultipleInterfaces("disable")
            .httpsImagePush("disable")
            .logMacLimitViolations("disable")
            .macAgingInterval(332)
            .macRetentionPeriod(24)
            .macViolationTimer(0)
            .build());

    }
}
Copy
resources:
  trname:
    type: fortios:switchcontroller:Global
    properties:
      allowMultipleInterfaces: disable
      httpsImagePush: disable
      logMacLimitViolations: disable
      macAgingInterval: 332
      macRetentionPeriod: 24
      macViolationTimer: 0
Copy

Create Global Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new Global(name: string, args?: GlobalArgs, opts?: CustomResourceOptions);
@overload
def Global(resource_name: str,
           args: Optional[GlobalArgs] = None,
           opts: Optional[ResourceOptions] = None)

@overload
def Global(resource_name: str,
           opts: Optional[ResourceOptions] = None,
           allow_multiple_interfaces: Optional[str] = None,
           bounce_quarantined_link: Optional[str] = None,
           custom_commands: Optional[Sequence[GlobalCustomCommandArgs]] = None,
           default_virtual_switch_vlan: Optional[str] = None,
           dhcp_option82_circuit_id: Optional[str] = None,
           dhcp_option82_format: Optional[str] = None,
           dhcp_option82_remote_id: Optional[str] = None,
           dhcp_server_access_list: Optional[str] = None,
           dhcp_snoop_client_db_exp: Optional[int] = None,
           dhcp_snoop_client_req: Optional[str] = None,
           dhcp_snoop_db_per_port_learn_limit: Optional[int] = None,
           disable_discoveries: Optional[Sequence[GlobalDisableDiscoveryArgs]] = None,
           dynamic_sort_subtable: Optional[str] = None,
           fips_enforce: Optional[str] = None,
           firmware_provision_on_authorization: Optional[str] = None,
           get_all_tables: Optional[str] = None,
           https_image_push: Optional[str] = None,
           log_mac_limit_violations: Optional[str] = None,
           mac_aging_interval: Optional[int] = None,
           mac_event_logging: Optional[str] = None,
           mac_retention_period: Optional[int] = None,
           mac_violation_timer: Optional[int] = None,
           quarantine_mode: Optional[str] = None,
           sn_dns_resolution: Optional[str] = None,
           update_user_device: Optional[str] = None,
           vdomparam: Optional[str] = None,
           vlan_all_mode: Optional[str] = None,
           vlan_identity: Optional[str] = None,
           vlan_optimization: Optional[str] = None)
func NewGlobal(ctx *Context, name string, args *GlobalArgs, opts ...ResourceOption) (*Global, error)
public Global(string name, GlobalArgs? args = null, CustomResourceOptions? opts = null)
public Global(String name, GlobalArgs args)
public Global(String name, GlobalArgs args, CustomResourceOptions options)
type: fortios:switchcontroller:Global
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args GlobalArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args GlobalArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args GlobalArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args GlobalArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. GlobalArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

Constructor example

The following reference example uses placeholder values for all input properties.

var exampleglobalResourceResourceFromSwitchcontrollerglobal = new Fortios.Switchcontroller.Global("exampleglobalResourceResourceFromSwitchcontrollerglobal", new()
{
    AllowMultipleInterfaces = "string",
    BounceQuarantinedLink = "string",
    CustomCommands = new[]
    {
        new Fortios.Switchcontroller.Inputs.GlobalCustomCommandArgs
        {
            CommandEntry = "string",
            CommandName = "string",
        },
    },
    DefaultVirtualSwitchVlan = "string",
    DhcpOption82CircuitId = "string",
    DhcpOption82Format = "string",
    DhcpOption82RemoteId = "string",
    DhcpServerAccessList = "string",
    DhcpSnoopClientDbExp = 0,
    DhcpSnoopClientReq = "string",
    DhcpSnoopDbPerPortLearnLimit = 0,
    DisableDiscoveries = new[]
    {
        new Fortios.Switchcontroller.Inputs.GlobalDisableDiscoveryArgs
        {
            Name = "string",
        },
    },
    DynamicSortSubtable = "string",
    FipsEnforce = "string",
    FirmwareProvisionOnAuthorization = "string",
    GetAllTables = "string",
    HttpsImagePush = "string",
    LogMacLimitViolations = "string",
    MacAgingInterval = 0,
    MacEventLogging = "string",
    MacRetentionPeriod = 0,
    MacViolationTimer = 0,
    QuarantineMode = "string",
    SnDnsResolution = "string",
    UpdateUserDevice = "string",
    Vdomparam = "string",
    VlanAllMode = "string",
    VlanIdentity = "string",
    VlanOptimization = "string",
});
Copy
example, err := switchcontroller.NewGlobal(ctx, "exampleglobalResourceResourceFromSwitchcontrollerglobal", &switchcontroller.GlobalArgs{
	AllowMultipleInterfaces: pulumi.String("string"),
	BounceQuarantinedLink:   pulumi.String("string"),
	CustomCommands: switchcontroller.GlobalCustomCommandArray{
		&switchcontroller.GlobalCustomCommandArgs{
			CommandEntry: pulumi.String("string"),
			CommandName:  pulumi.String("string"),
		},
	},
	DefaultVirtualSwitchVlan:     pulumi.String("string"),
	DhcpOption82CircuitId:        pulumi.String("string"),
	DhcpOption82Format:           pulumi.String("string"),
	DhcpOption82RemoteId:         pulumi.String("string"),
	DhcpServerAccessList:         pulumi.String("string"),
	DhcpSnoopClientDbExp:         pulumi.Int(0),
	DhcpSnoopClientReq:           pulumi.String("string"),
	DhcpSnoopDbPerPortLearnLimit: pulumi.Int(0),
	DisableDiscoveries: switchcontroller.GlobalDisableDiscoveryArray{
		&switchcontroller.GlobalDisableDiscoveryArgs{
			Name: pulumi.String("string"),
		},
	},
	DynamicSortSubtable:              pulumi.String("string"),
	FipsEnforce:                      pulumi.String("string"),
	FirmwareProvisionOnAuthorization: pulumi.String("string"),
	GetAllTables:                     pulumi.String("string"),
	HttpsImagePush:                   pulumi.String("string"),
	LogMacLimitViolations:            pulumi.String("string"),
	MacAgingInterval:                 pulumi.Int(0),
	MacEventLogging:                  pulumi.String("string"),
	MacRetentionPeriod:               pulumi.Int(0),
	MacViolationTimer:                pulumi.Int(0),
	QuarantineMode:                   pulumi.String("string"),
	SnDnsResolution:                  pulumi.String("string"),
	UpdateUserDevice:                 pulumi.String("string"),
	Vdomparam:                        pulumi.String("string"),
	VlanAllMode:                      pulumi.String("string"),
	VlanIdentity:                     pulumi.String("string"),
	VlanOptimization:                 pulumi.String("string"),
})
Copy
var exampleglobalResourceResourceFromSwitchcontrollerglobal = new Global("exampleglobalResourceResourceFromSwitchcontrollerglobal", GlobalArgs.builder()
    .allowMultipleInterfaces("string")
    .bounceQuarantinedLink("string")
    .customCommands(GlobalCustomCommandArgs.builder()
        .commandEntry("string")
        .commandName("string")
        .build())
    .defaultVirtualSwitchVlan("string")
    .dhcpOption82CircuitId("string")
    .dhcpOption82Format("string")
    .dhcpOption82RemoteId("string")
    .dhcpServerAccessList("string")
    .dhcpSnoopClientDbExp(0)
    .dhcpSnoopClientReq("string")
    .dhcpSnoopDbPerPortLearnLimit(0)
    .disableDiscoveries(GlobalDisableDiscoveryArgs.builder()
        .name("string")
        .build())
    .dynamicSortSubtable("string")
    .fipsEnforce("string")
    .firmwareProvisionOnAuthorization("string")
    .getAllTables("string")
    .httpsImagePush("string")
    .logMacLimitViolations("string")
    .macAgingInterval(0)
    .macEventLogging("string")
    .macRetentionPeriod(0)
    .macViolationTimer(0)
    .quarantineMode("string")
    .snDnsResolution("string")
    .updateUserDevice("string")
    .vdomparam("string")
    .vlanAllMode("string")
    .vlanIdentity("string")
    .vlanOptimization("string")
    .build());
Copy
exampleglobal_resource_resource_from_switchcontrollerglobal = fortios.switchcontroller.Global("exampleglobalResourceResourceFromSwitchcontrollerglobal",
    allow_multiple_interfaces="string",
    bounce_quarantined_link="string",
    custom_commands=[{
        "command_entry": "string",
        "command_name": "string",
    }],
    default_virtual_switch_vlan="string",
    dhcp_option82_circuit_id="string",
    dhcp_option82_format="string",
    dhcp_option82_remote_id="string",
    dhcp_server_access_list="string",
    dhcp_snoop_client_db_exp=0,
    dhcp_snoop_client_req="string",
    dhcp_snoop_db_per_port_learn_limit=0,
    disable_discoveries=[{
        "name": "string",
    }],
    dynamic_sort_subtable="string",
    fips_enforce="string",
    firmware_provision_on_authorization="string",
    get_all_tables="string",
    https_image_push="string",
    log_mac_limit_violations="string",
    mac_aging_interval=0,
    mac_event_logging="string",
    mac_retention_period=0,
    mac_violation_timer=0,
    quarantine_mode="string",
    sn_dns_resolution="string",
    update_user_device="string",
    vdomparam="string",
    vlan_all_mode="string",
    vlan_identity="string",
    vlan_optimization="string")
Copy
const exampleglobalResourceResourceFromSwitchcontrollerglobal = new fortios.switchcontroller.Global("exampleglobalResourceResourceFromSwitchcontrollerglobal", {
    allowMultipleInterfaces: "string",
    bounceQuarantinedLink: "string",
    customCommands: [{
        commandEntry: "string",
        commandName: "string",
    }],
    defaultVirtualSwitchVlan: "string",
    dhcpOption82CircuitId: "string",
    dhcpOption82Format: "string",
    dhcpOption82RemoteId: "string",
    dhcpServerAccessList: "string",
    dhcpSnoopClientDbExp: 0,
    dhcpSnoopClientReq: "string",
    dhcpSnoopDbPerPortLearnLimit: 0,
    disableDiscoveries: [{
        name: "string",
    }],
    dynamicSortSubtable: "string",
    fipsEnforce: "string",
    firmwareProvisionOnAuthorization: "string",
    getAllTables: "string",
    httpsImagePush: "string",
    logMacLimitViolations: "string",
    macAgingInterval: 0,
    macEventLogging: "string",
    macRetentionPeriod: 0,
    macViolationTimer: 0,
    quarantineMode: "string",
    snDnsResolution: "string",
    updateUserDevice: "string",
    vdomparam: "string",
    vlanAllMode: "string",
    vlanIdentity: "string",
    vlanOptimization: "string",
});
Copy
type: fortios:switchcontroller:Global
properties:
    allowMultipleInterfaces: string
    bounceQuarantinedLink: string
    customCommands:
        - commandEntry: string
          commandName: string
    defaultVirtualSwitchVlan: string
    dhcpOption82CircuitId: string
    dhcpOption82Format: string
    dhcpOption82RemoteId: string
    dhcpServerAccessList: string
    dhcpSnoopClientDbExp: 0
    dhcpSnoopClientReq: string
    dhcpSnoopDbPerPortLearnLimit: 0
    disableDiscoveries:
        - name: string
    dynamicSortSubtable: string
    fipsEnforce: string
    firmwareProvisionOnAuthorization: string
    getAllTables: string
    httpsImagePush: string
    logMacLimitViolations: string
    macAgingInterval: 0
    macEventLogging: string
    macRetentionPeriod: 0
    macViolationTimer: 0
    quarantineMode: string
    snDnsResolution: string
    updateUserDevice: string
    vdomparam: string
    vlanAllMode: string
    vlanIdentity: string
    vlanOptimization: string
Copy

Global Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The Global resource accepts the following input properties:

AllowMultipleInterfaces string
Enable/disable multiple FortiLink interfaces for redundant connections between a managed FortiSwitch and FortiGate. Valid values: enable, disable.
BounceQuarantinedLink string
Enable/disable bouncing (administratively bring the link down, up) of a switch port where a quarantined device was seen last. Helps to re-initiate the DHCP process for a device. Valid values: disable, enable.
CustomCommands List<Pulumiverse.Fortios.Switchcontroller.Inputs.GlobalCustomCommand>
List of custom commands to be pushed to all FortiSwitches in the VDOM. The structure of custom_command block is documented below.
DefaultVirtualSwitchVlan string
Default VLAN for ports when added to the virtual-switch.
DhcpOption82CircuitId string
List the parameters to be included to inform about client identification. Valid values: intfname, vlan, hostname, mode, description.
DhcpOption82Format string
DHCP option-82 format string. Valid values: ascii, legacy.
DhcpOption82RemoteId string
List the parameters to be included to inform about client identification. Valid values: mac, hostname, ip.
DhcpServerAccessList string
Enable/disable DHCP snooping server access list. Valid values: enable, disable.
DhcpSnoopClientDbExp int
Expiry time for DHCP snooping server database entries (300 - 259200 sec, default = 86400 sec).
DhcpSnoopClientReq string
Client DHCP packet broadcast mode. Valid values: drop-untrusted, forward-untrusted.
DhcpSnoopDbPerPortLearnLimit int
Per Interface dhcp-server entries learn limit (0 - 1024, default = 64).
DisableDiscoveries List<Pulumiverse.Fortios.Switchcontroller.Inputs.GlobalDisableDiscovery>
Prevent this FortiSwitch from discovering. The structure of disable_discovery block is documented below.
DynamicSortSubtable string
Sort sub-tables, please do not set this parameter when configuring static sub-tables. Options: [ false, true, natural, alphabetical ]. false: Default value, do not sort tables; true/natural: sort tables in natural order. For example: [ a10, a2 ] -> [ a2, a10 ]; alphabetical: sort tables in alphabetical order. For example: [ a10, a2 ] -> [ a10, a2 ].
FipsEnforce string
Enable/disable enforcement of FIPS on managed FortiSwitch devices. Valid values: disable, enable.
FirmwareProvisionOnAuthorization string
Enable/disable automatic provisioning of latest firmware on authorization. Valid values: enable, disable.
GetAllTables string
Get all sub-tables including unconfigured tables. Do not set this variable to true if you configure sub-table in another resource, otherwise, conflicts and overwrite will occur. Options: [ false, true ]. false: Default value, do not get unconfigured tables; true: get all tables including unconfigured tables.
HttpsImagePush string
Enable/disable image push to FortiSwitch using HTTPS. Valid values: enable, disable.
LogMacLimitViolations string
Enable/disable logs for Learning Limit Violations. Valid values: enable, disable.
MacAgingInterval int
Time after which an inactive MAC is aged out (10 - 1000000 sec, default = 300, 0 = disable).
MacEventLogging string
Enable/disable MAC address event logging. Valid values: enable, disable.
MacRetentionPeriod int
Time in hours after which an inactive MAC is removed from client DB (0 = aged out based on mac-aging-interval).
MacViolationTimer int
Set timeout for Learning Limit Violations (0 = disabled).
QuarantineMode string
Quarantine mode. Valid values: by-vlan, by-redirect.
SnDnsResolution string
Enable/disable DNS resolution of the FortiSwitch unit's IP address by use of its serial number. Valid values: enable, disable.
UpdateUserDevice string
Control which sources update the device user list. Valid values: mac-cache, lldp, dhcp-snooping, l2-db, l3-db.
Vdomparam Changes to this property will trigger replacement. string
Specifies the vdom to which the resource will be applied when the FortiGate unit is running in VDOM mode. Only one vdom can be specified. If you want to inherit the vdom configuration of the provider, please do not set this parameter.
VlanAllMode string
VLAN configuration mode, user-defined-vlans or all-possible-vlans. Valid values: all, defined.
VlanIdentity string
Identity of the VLAN. Commonly used for RADIUS Tunnel-Private-Group-Id. Valid values: description, name.
VlanOptimization string
FortiLink VLAN optimization. Valid values: enable, disable.
AllowMultipleInterfaces string
Enable/disable multiple FortiLink interfaces for redundant connections between a managed FortiSwitch and FortiGate. Valid values: enable, disable.
BounceQuarantinedLink string
Enable/disable bouncing (administratively bring the link down, up) of a switch port where a quarantined device was seen last. Helps to re-initiate the DHCP process for a device. Valid values: disable, enable.
CustomCommands []GlobalCustomCommandArgs
List of custom commands to be pushed to all FortiSwitches in the VDOM. The structure of custom_command block is documented below.
DefaultVirtualSwitchVlan string
Default VLAN for ports when added to the virtual-switch.
DhcpOption82CircuitId string
List the parameters to be included to inform about client identification. Valid values: intfname, vlan, hostname, mode, description.
DhcpOption82Format string
DHCP option-82 format string. Valid values: ascii, legacy.
DhcpOption82RemoteId string
List the parameters to be included to inform about client identification. Valid values: mac, hostname, ip.
DhcpServerAccessList string
Enable/disable DHCP snooping server access list. Valid values: enable, disable.
DhcpSnoopClientDbExp int
Expiry time for DHCP snooping server database entries (300 - 259200 sec, default = 86400 sec).
DhcpSnoopClientReq string
Client DHCP packet broadcast mode. Valid values: drop-untrusted, forward-untrusted.
DhcpSnoopDbPerPortLearnLimit int
Per Interface dhcp-server entries learn limit (0 - 1024, default = 64).
DisableDiscoveries []GlobalDisableDiscoveryArgs
Prevent this FortiSwitch from discovering. The structure of disable_discovery block is documented below.
DynamicSortSubtable string
Sort sub-tables, please do not set this parameter when configuring static sub-tables. Options: [ false, true, natural, alphabetical ]. false: Default value, do not sort tables; true/natural: sort tables in natural order. For example: [ a10, a2 ] -> [ a2, a10 ]; alphabetical: sort tables in alphabetical order. For example: [ a10, a2 ] -> [ a10, a2 ].
FipsEnforce string
Enable/disable enforcement of FIPS on managed FortiSwitch devices. Valid values: disable, enable.
FirmwareProvisionOnAuthorization string
Enable/disable automatic provisioning of latest firmware on authorization. Valid values: enable, disable.
GetAllTables string
Get all sub-tables including unconfigured tables. Do not set this variable to true if you configure sub-table in another resource, otherwise, conflicts and overwrite will occur. Options: [ false, true ]. false: Default value, do not get unconfigured tables; true: get all tables including unconfigured tables.
HttpsImagePush string
Enable/disable image push to FortiSwitch using HTTPS. Valid values: enable, disable.
LogMacLimitViolations string
Enable/disable logs for Learning Limit Violations. Valid values: enable, disable.
MacAgingInterval int
Time after which an inactive MAC is aged out (10 - 1000000 sec, default = 300, 0 = disable).
MacEventLogging string
Enable/disable MAC address event logging. Valid values: enable, disable.
MacRetentionPeriod int
Time in hours after which an inactive MAC is removed from client DB (0 = aged out based on mac-aging-interval).
MacViolationTimer int
Set timeout for Learning Limit Violations (0 = disabled).
QuarantineMode string
Quarantine mode. Valid values: by-vlan, by-redirect.
SnDnsResolution string
Enable/disable DNS resolution of the FortiSwitch unit's IP address by use of its serial number. Valid values: enable, disable.
UpdateUserDevice string
Control which sources update the device user list. Valid values: mac-cache, lldp, dhcp-snooping, l2-db, l3-db.
Vdomparam Changes to this property will trigger replacement. string
Specifies the vdom to which the resource will be applied when the FortiGate unit is running in VDOM mode. Only one vdom can be specified. If you want to inherit the vdom configuration of the provider, please do not set this parameter.
VlanAllMode string
VLAN configuration mode, user-defined-vlans or all-possible-vlans. Valid values: all, defined.
VlanIdentity string
Identity of the VLAN. Commonly used for RADIUS Tunnel-Private-Group-Id. Valid values: description, name.
VlanOptimization string
FortiLink VLAN optimization. Valid values: enable, disable.
allowMultipleInterfaces String
Enable/disable multiple FortiLink interfaces for redundant connections between a managed FortiSwitch and FortiGate. Valid values: enable, disable.
bounceQuarantinedLink String
Enable/disable bouncing (administratively bring the link down, up) of a switch port where a quarantined device was seen last. Helps to re-initiate the DHCP process for a device. Valid values: disable, enable.
customCommands List<GlobalCustomCommand>
List of custom commands to be pushed to all FortiSwitches in the VDOM. The structure of custom_command block is documented below.
defaultVirtualSwitchVlan String
Default VLAN for ports when added to the virtual-switch.
dhcpOption82CircuitId String
List the parameters to be included to inform about client identification. Valid values: intfname, vlan, hostname, mode, description.
dhcpOption82Format String
DHCP option-82 format string. Valid values: ascii, legacy.
dhcpOption82RemoteId String
List the parameters to be included to inform about client identification. Valid values: mac, hostname, ip.
dhcpServerAccessList String
Enable/disable DHCP snooping server access list. Valid values: enable, disable.
dhcpSnoopClientDbExp Integer
Expiry time for DHCP snooping server database entries (300 - 259200 sec, default = 86400 sec).
dhcpSnoopClientReq String
Client DHCP packet broadcast mode. Valid values: drop-untrusted, forward-untrusted.
dhcpSnoopDbPerPortLearnLimit Integer
Per Interface dhcp-server entries learn limit (0 - 1024, default = 64).
disableDiscoveries List<GlobalDisableDiscovery>
Prevent this FortiSwitch from discovering. The structure of disable_discovery block is documented below.
dynamicSortSubtable String
Sort sub-tables, please do not set this parameter when configuring static sub-tables. Options: [ false, true, natural, alphabetical ]. false: Default value, do not sort tables; true/natural: sort tables in natural order. For example: [ a10, a2 ] -> [ a2, a10 ]; alphabetical: sort tables in alphabetical order. For example: [ a10, a2 ] -> [ a10, a2 ].
fipsEnforce String
Enable/disable enforcement of FIPS on managed FortiSwitch devices. Valid values: disable, enable.
firmwareProvisionOnAuthorization String
Enable/disable automatic provisioning of latest firmware on authorization. Valid values: enable, disable.
getAllTables String
Get all sub-tables including unconfigured tables. Do not set this variable to true if you configure sub-table in another resource, otherwise, conflicts and overwrite will occur. Options: [ false, true ]. false: Default value, do not get unconfigured tables; true: get all tables including unconfigured tables.
httpsImagePush String
Enable/disable image push to FortiSwitch using HTTPS. Valid values: enable, disable.
logMacLimitViolations String
Enable/disable logs for Learning Limit Violations. Valid values: enable, disable.
macAgingInterval Integer
Time after which an inactive MAC is aged out (10 - 1000000 sec, default = 300, 0 = disable).
macEventLogging String
Enable/disable MAC address event logging. Valid values: enable, disable.
macRetentionPeriod Integer
Time in hours after which an inactive MAC is removed from client DB (0 = aged out based on mac-aging-interval).
macViolationTimer Integer
Set timeout for Learning Limit Violations (0 = disabled).
quarantineMode String
Quarantine mode. Valid values: by-vlan, by-redirect.
snDnsResolution String
Enable/disable DNS resolution of the FortiSwitch unit's IP address by use of its serial number. Valid values: enable, disable.
updateUserDevice String
Control which sources update the device user list. Valid values: mac-cache, lldp, dhcp-snooping, l2-db, l3-db.
vdomparam Changes to this property will trigger replacement. String
Specifies the vdom to which the resource will be applied when the FortiGate unit is running in VDOM mode. Only one vdom can be specified. If you want to inherit the vdom configuration of the provider, please do not set this parameter.
vlanAllMode String
VLAN configuration mode, user-defined-vlans or all-possible-vlans. Valid values: all, defined.
vlanIdentity String
Identity of the VLAN. Commonly used for RADIUS Tunnel-Private-Group-Id. Valid values: description, name.
vlanOptimization String
FortiLink VLAN optimization. Valid values: enable, disable.
allowMultipleInterfaces string
Enable/disable multiple FortiLink interfaces for redundant connections between a managed FortiSwitch and FortiGate. Valid values: enable, disable.
bounceQuarantinedLink string
Enable/disable bouncing (administratively bring the link down, up) of a switch port where a quarantined device was seen last. Helps to re-initiate the DHCP process for a device. Valid values: disable, enable.
customCommands GlobalCustomCommand[]
List of custom commands to be pushed to all FortiSwitches in the VDOM. The structure of custom_command block is documented below.
defaultVirtualSwitchVlan string
Default VLAN for ports when added to the virtual-switch.
dhcpOption82CircuitId string
List the parameters to be included to inform about client identification. Valid values: intfname, vlan, hostname, mode, description.
dhcpOption82Format string
DHCP option-82 format string. Valid values: ascii, legacy.
dhcpOption82RemoteId string
List the parameters to be included to inform about client identification. Valid values: mac, hostname, ip.
dhcpServerAccessList string
Enable/disable DHCP snooping server access list. Valid values: enable, disable.
dhcpSnoopClientDbExp number
Expiry time for DHCP snooping server database entries (300 - 259200 sec, default = 86400 sec).
dhcpSnoopClientReq string
Client DHCP packet broadcast mode. Valid values: drop-untrusted, forward-untrusted.
dhcpSnoopDbPerPortLearnLimit number
Per Interface dhcp-server entries learn limit (0 - 1024, default = 64).
disableDiscoveries GlobalDisableDiscovery[]
Prevent this FortiSwitch from discovering. The structure of disable_discovery block is documented below.
dynamicSortSubtable string
Sort sub-tables, please do not set this parameter when configuring static sub-tables. Options: [ false, true, natural, alphabetical ]. false: Default value, do not sort tables; true/natural: sort tables in natural order. For example: [ a10, a2 ] -> [ a2, a10 ]; alphabetical: sort tables in alphabetical order. For example: [ a10, a2 ] -> [ a10, a2 ].
fipsEnforce string
Enable/disable enforcement of FIPS on managed FortiSwitch devices. Valid values: disable, enable.
firmwareProvisionOnAuthorization string
Enable/disable automatic provisioning of latest firmware on authorization. Valid values: enable, disable.
getAllTables string
Get all sub-tables including unconfigured tables. Do not set this variable to true if you configure sub-table in another resource, otherwise, conflicts and overwrite will occur. Options: [ false, true ]. false: Default value, do not get unconfigured tables; true: get all tables including unconfigured tables.
httpsImagePush string
Enable/disable image push to FortiSwitch using HTTPS. Valid values: enable, disable.
logMacLimitViolations string
Enable/disable logs for Learning Limit Violations. Valid values: enable, disable.
macAgingInterval number
Time after which an inactive MAC is aged out (10 - 1000000 sec, default = 300, 0 = disable).
macEventLogging string
Enable/disable MAC address event logging. Valid values: enable, disable.
macRetentionPeriod number
Time in hours after which an inactive MAC is removed from client DB (0 = aged out based on mac-aging-interval).
macViolationTimer number
Set timeout for Learning Limit Violations (0 = disabled).
quarantineMode string
Quarantine mode. Valid values: by-vlan, by-redirect.
snDnsResolution string
Enable/disable DNS resolution of the FortiSwitch unit's IP address by use of its serial number. Valid values: enable, disable.
updateUserDevice string
Control which sources update the device user list. Valid values: mac-cache, lldp, dhcp-snooping, l2-db, l3-db.
vdomparam Changes to this property will trigger replacement. string
Specifies the vdom to which the resource will be applied when the FortiGate unit is running in VDOM mode. Only one vdom can be specified. If you want to inherit the vdom configuration of the provider, please do not set this parameter.
vlanAllMode string
VLAN configuration mode, user-defined-vlans or all-possible-vlans. Valid values: all, defined.
vlanIdentity string
Identity of the VLAN. Commonly used for RADIUS Tunnel-Private-Group-Id. Valid values: description, name.
vlanOptimization string
FortiLink VLAN optimization. Valid values: enable, disable.
allow_multiple_interfaces str
Enable/disable multiple FortiLink interfaces for redundant connections between a managed FortiSwitch and FortiGate. Valid values: enable, disable.
bounce_quarantined_link str
Enable/disable bouncing (administratively bring the link down, up) of a switch port where a quarantined device was seen last. Helps to re-initiate the DHCP process for a device. Valid values: disable, enable.
custom_commands Sequence[GlobalCustomCommandArgs]
List of custom commands to be pushed to all FortiSwitches in the VDOM. The structure of custom_command block is documented below.
default_virtual_switch_vlan str
Default VLAN for ports when added to the virtual-switch.
dhcp_option82_circuit_id str
List the parameters to be included to inform about client identification. Valid values: intfname, vlan, hostname, mode, description.
dhcp_option82_format str
DHCP option-82 format string. Valid values: ascii, legacy.
dhcp_option82_remote_id str
List the parameters to be included to inform about client identification. Valid values: mac, hostname, ip.
dhcp_server_access_list str
Enable/disable DHCP snooping server access list. Valid values: enable, disable.
dhcp_snoop_client_db_exp int
Expiry time for DHCP snooping server database entries (300 - 259200 sec, default = 86400 sec).
dhcp_snoop_client_req str
Client DHCP packet broadcast mode. Valid values: drop-untrusted, forward-untrusted.
dhcp_snoop_db_per_port_learn_limit int
Per Interface dhcp-server entries learn limit (0 - 1024, default = 64).
disable_discoveries Sequence[GlobalDisableDiscoveryArgs]
Prevent this FortiSwitch from discovering. The structure of disable_discovery block is documented below.
dynamic_sort_subtable str
Sort sub-tables, please do not set this parameter when configuring static sub-tables. Options: [ false, true, natural, alphabetical ]. false: Default value, do not sort tables; true/natural: sort tables in natural order. For example: [ a10, a2 ] -> [ a2, a10 ]; alphabetical: sort tables in alphabetical order. For example: [ a10, a2 ] -> [ a10, a2 ].
fips_enforce str
Enable/disable enforcement of FIPS on managed FortiSwitch devices. Valid values: disable, enable.
firmware_provision_on_authorization str
Enable/disable automatic provisioning of latest firmware on authorization. Valid values: enable, disable.
get_all_tables str
Get all sub-tables including unconfigured tables. Do not set this variable to true if you configure sub-table in another resource, otherwise, conflicts and overwrite will occur. Options: [ false, true ]. false: Default value, do not get unconfigured tables; true: get all tables including unconfigured tables.
https_image_push str
Enable/disable image push to FortiSwitch using HTTPS. Valid values: enable, disable.
log_mac_limit_violations str
Enable/disable logs for Learning Limit Violations. Valid values: enable, disable.
mac_aging_interval int
Time after which an inactive MAC is aged out (10 - 1000000 sec, default = 300, 0 = disable).
mac_event_logging str
Enable/disable MAC address event logging. Valid values: enable, disable.
mac_retention_period int
Time in hours after which an inactive MAC is removed from client DB (0 = aged out based on mac-aging-interval).
mac_violation_timer int
Set timeout for Learning Limit Violations (0 = disabled).
quarantine_mode str
Quarantine mode. Valid values: by-vlan, by-redirect.
sn_dns_resolution str
Enable/disable DNS resolution of the FortiSwitch unit's IP address by use of its serial number. Valid values: enable, disable.
update_user_device str
Control which sources update the device user list. Valid values: mac-cache, lldp, dhcp-snooping, l2-db, l3-db.
vdomparam Changes to this property will trigger replacement. str
Specifies the vdom to which the resource will be applied when the FortiGate unit is running in VDOM mode. Only one vdom can be specified. If you want to inherit the vdom configuration of the provider, please do not set this parameter.
vlan_all_mode str
VLAN configuration mode, user-defined-vlans or all-possible-vlans. Valid values: all, defined.
vlan_identity str
Identity of the VLAN. Commonly used for RADIUS Tunnel-Private-Group-Id. Valid values: description, name.
vlan_optimization str
FortiLink VLAN optimization. Valid values: enable, disable.
allowMultipleInterfaces String
Enable/disable multiple FortiLink interfaces for redundant connections between a managed FortiSwitch and FortiGate. Valid values: enable, disable.
bounceQuarantinedLink String
Enable/disable bouncing (administratively bring the link down, up) of a switch port where a quarantined device was seen last. Helps to re-initiate the DHCP process for a device. Valid values: disable, enable.
customCommands List<Property Map>
List of custom commands to be pushed to all FortiSwitches in the VDOM. The structure of custom_command block is documented below.
defaultVirtualSwitchVlan String
Default VLAN for ports when added to the virtual-switch.
dhcpOption82CircuitId String
List the parameters to be included to inform about client identification. Valid values: intfname, vlan, hostname, mode, description.
dhcpOption82Format String
DHCP option-82 format string. Valid values: ascii, legacy.
dhcpOption82RemoteId String
List the parameters to be included to inform about client identification. Valid values: mac, hostname, ip.
dhcpServerAccessList String
Enable/disable DHCP snooping server access list. Valid values: enable, disable.
dhcpSnoopClientDbExp Number
Expiry time for DHCP snooping server database entries (300 - 259200 sec, default = 86400 sec).
dhcpSnoopClientReq String
Client DHCP packet broadcast mode. Valid values: drop-untrusted, forward-untrusted.
dhcpSnoopDbPerPortLearnLimit Number
Per Interface dhcp-server entries learn limit (0 - 1024, default = 64).
disableDiscoveries List<Property Map>
Prevent this FortiSwitch from discovering. The structure of disable_discovery block is documented below.
dynamicSortSubtable String
Sort sub-tables, please do not set this parameter when configuring static sub-tables. Options: [ false, true, natural, alphabetical ]. false: Default value, do not sort tables; true/natural: sort tables in natural order. For example: [ a10, a2 ] -> [ a2, a10 ]; alphabetical: sort tables in alphabetical order. For example: [ a10, a2 ] -> [ a10, a2 ].
fipsEnforce String
Enable/disable enforcement of FIPS on managed FortiSwitch devices. Valid values: disable, enable.
firmwareProvisionOnAuthorization String
Enable/disable automatic provisioning of latest firmware on authorization. Valid values: enable, disable.
getAllTables String
Get all sub-tables including unconfigured tables. Do not set this variable to true if you configure sub-table in another resource, otherwise, conflicts and overwrite will occur. Options: [ false, true ]. false: Default value, do not get unconfigured tables; true: get all tables including unconfigured tables.
httpsImagePush String
Enable/disable image push to FortiSwitch using HTTPS. Valid values: enable, disable.
logMacLimitViolations String
Enable/disable logs for Learning Limit Violations. Valid values: enable, disable.
macAgingInterval Number
Time after which an inactive MAC is aged out (10 - 1000000 sec, default = 300, 0 = disable).
macEventLogging String
Enable/disable MAC address event logging. Valid values: enable, disable.
macRetentionPeriod Number
Time in hours after which an inactive MAC is removed from client DB (0 = aged out based on mac-aging-interval).
macViolationTimer Number
Set timeout for Learning Limit Violations (0 = disabled).
quarantineMode String
Quarantine mode. Valid values: by-vlan, by-redirect.
snDnsResolution String
Enable/disable DNS resolution of the FortiSwitch unit's IP address by use of its serial number. Valid values: enable, disable.
updateUserDevice String
Control which sources update the device user list. Valid values: mac-cache, lldp, dhcp-snooping, l2-db, l3-db.
vdomparam Changes to this property will trigger replacement. String
Specifies the vdom to which the resource will be applied when the FortiGate unit is running in VDOM mode. Only one vdom can be specified. If you want to inherit the vdom configuration of the provider, please do not set this parameter.
vlanAllMode String
VLAN configuration mode, user-defined-vlans or all-possible-vlans. Valid values: all, defined.
vlanIdentity String
Identity of the VLAN. Commonly used for RADIUS Tunnel-Private-Group-Id. Valid values: description, name.
vlanOptimization String
FortiLink VLAN optimization. Valid values: enable, disable.

Outputs

All input properties are implicitly available as output properties. Additionally, the Global resource produces the following output properties:

Id string
The provider-assigned unique ID for this managed resource.
Id string
The provider-assigned unique ID for this managed resource.
id String
The provider-assigned unique ID for this managed resource.
id string
The provider-assigned unique ID for this managed resource.
id str
The provider-assigned unique ID for this managed resource.
id String
The provider-assigned unique ID for this managed resource.

Look up Existing Global Resource

Get an existing Global resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: GlobalState, opts?: CustomResourceOptions): Global
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        allow_multiple_interfaces: Optional[str] = None,
        bounce_quarantined_link: Optional[str] = None,
        custom_commands: Optional[Sequence[GlobalCustomCommandArgs]] = None,
        default_virtual_switch_vlan: Optional[str] = None,
        dhcp_option82_circuit_id: Optional[str] = None,
        dhcp_option82_format: Optional[str] = None,
        dhcp_option82_remote_id: Optional[str] = None,
        dhcp_server_access_list: Optional[str] = None,
        dhcp_snoop_client_db_exp: Optional[int] = None,
        dhcp_snoop_client_req: Optional[str] = None,
        dhcp_snoop_db_per_port_learn_limit: Optional[int] = None,
        disable_discoveries: Optional[Sequence[GlobalDisableDiscoveryArgs]] = None,
        dynamic_sort_subtable: Optional[str] = None,
        fips_enforce: Optional[str] = None,
        firmware_provision_on_authorization: Optional[str] = None,
        get_all_tables: Optional[str] = None,
        https_image_push: Optional[str] = None,
        log_mac_limit_violations: Optional[str] = None,
        mac_aging_interval: Optional[int] = None,
        mac_event_logging: Optional[str] = None,
        mac_retention_period: Optional[int] = None,
        mac_violation_timer: Optional[int] = None,
        quarantine_mode: Optional[str] = None,
        sn_dns_resolution: Optional[str] = None,
        update_user_device: Optional[str] = None,
        vdomparam: Optional[str] = None,
        vlan_all_mode: Optional[str] = None,
        vlan_identity: Optional[str] = None,
        vlan_optimization: Optional[str] = None) -> Global
func GetGlobal(ctx *Context, name string, id IDInput, state *GlobalState, opts ...ResourceOption) (*Global, error)
public static Global Get(string name, Input<string> id, GlobalState? state, CustomResourceOptions? opts = null)
public static Global get(String name, Output<String> id, GlobalState state, CustomResourceOptions options)
resources:  _:    type: fortios:switchcontroller:Global    get:      id: ${id}
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
The following state arguments are supported:
AllowMultipleInterfaces string
Enable/disable multiple FortiLink interfaces for redundant connections between a managed FortiSwitch and FortiGate. Valid values: enable, disable.
BounceQuarantinedLink string
Enable/disable bouncing (administratively bring the link down, up) of a switch port where a quarantined device was seen last. Helps to re-initiate the DHCP process for a device. Valid values: disable, enable.
CustomCommands List<Pulumiverse.Fortios.Switchcontroller.Inputs.GlobalCustomCommand>
List of custom commands to be pushed to all FortiSwitches in the VDOM. The structure of custom_command block is documented below.
DefaultVirtualSwitchVlan string
Default VLAN for ports when added to the virtual-switch.
DhcpOption82CircuitId string
List the parameters to be included to inform about client identification. Valid values: intfname, vlan, hostname, mode, description.
DhcpOption82Format string
DHCP option-82 format string. Valid values: ascii, legacy.
DhcpOption82RemoteId string
List the parameters to be included to inform about client identification. Valid values: mac, hostname, ip.
DhcpServerAccessList string
Enable/disable DHCP snooping server access list. Valid values: enable, disable.
DhcpSnoopClientDbExp int
Expiry time for DHCP snooping server database entries (300 - 259200 sec, default = 86400 sec).
DhcpSnoopClientReq string
Client DHCP packet broadcast mode. Valid values: drop-untrusted, forward-untrusted.
DhcpSnoopDbPerPortLearnLimit int
Per Interface dhcp-server entries learn limit (0 - 1024, default = 64).
DisableDiscoveries List<Pulumiverse.Fortios.Switchcontroller.Inputs.GlobalDisableDiscovery>
Prevent this FortiSwitch from discovering. The structure of disable_discovery block is documented below.
DynamicSortSubtable string
Sort sub-tables, please do not set this parameter when configuring static sub-tables. Options: [ false, true, natural, alphabetical ]. false: Default value, do not sort tables; true/natural: sort tables in natural order. For example: [ a10, a2 ] -> [ a2, a10 ]; alphabetical: sort tables in alphabetical order. For example: [ a10, a2 ] -> [ a10, a2 ].
FipsEnforce string
Enable/disable enforcement of FIPS on managed FortiSwitch devices. Valid values: disable, enable.
FirmwareProvisionOnAuthorization string
Enable/disable automatic provisioning of latest firmware on authorization. Valid values: enable, disable.
GetAllTables string
Get all sub-tables including unconfigured tables. Do not set this variable to true if you configure sub-table in another resource, otherwise, conflicts and overwrite will occur. Options: [ false, true ]. false: Default value, do not get unconfigured tables; true: get all tables including unconfigured tables.
HttpsImagePush string
Enable/disable image push to FortiSwitch using HTTPS. Valid values: enable, disable.
LogMacLimitViolations string
Enable/disable logs for Learning Limit Violations. Valid values: enable, disable.
MacAgingInterval int
Time after which an inactive MAC is aged out (10 - 1000000 sec, default = 300, 0 = disable).
MacEventLogging string
Enable/disable MAC address event logging. Valid values: enable, disable.
MacRetentionPeriod int
Time in hours after which an inactive MAC is removed from client DB (0 = aged out based on mac-aging-interval).
MacViolationTimer int
Set timeout for Learning Limit Violations (0 = disabled).
QuarantineMode string
Quarantine mode. Valid values: by-vlan, by-redirect.
SnDnsResolution string
Enable/disable DNS resolution of the FortiSwitch unit's IP address by use of its serial number. Valid values: enable, disable.
UpdateUserDevice string
Control which sources update the device user list. Valid values: mac-cache, lldp, dhcp-snooping, l2-db, l3-db.
Vdomparam Changes to this property will trigger replacement. string
Specifies the vdom to which the resource will be applied when the FortiGate unit is running in VDOM mode. Only one vdom can be specified. If you want to inherit the vdom configuration of the provider, please do not set this parameter.
VlanAllMode string
VLAN configuration mode, user-defined-vlans or all-possible-vlans. Valid values: all, defined.
VlanIdentity string
Identity of the VLAN. Commonly used for RADIUS Tunnel-Private-Group-Id. Valid values: description, name.
VlanOptimization string
FortiLink VLAN optimization. Valid values: enable, disable.
AllowMultipleInterfaces string
Enable/disable multiple FortiLink interfaces for redundant connections between a managed FortiSwitch and FortiGate. Valid values: enable, disable.
BounceQuarantinedLink string
Enable/disable bouncing (administratively bring the link down, up) of a switch port where a quarantined device was seen last. Helps to re-initiate the DHCP process for a device. Valid values: disable, enable.
CustomCommands []GlobalCustomCommandArgs
List of custom commands to be pushed to all FortiSwitches in the VDOM. The structure of custom_command block is documented below.
DefaultVirtualSwitchVlan string
Default VLAN for ports when added to the virtual-switch.
DhcpOption82CircuitId string
List the parameters to be included to inform about client identification. Valid values: intfname, vlan, hostname, mode, description.
DhcpOption82Format string
DHCP option-82 format string. Valid values: ascii, legacy.
DhcpOption82RemoteId string
List the parameters to be included to inform about client identification. Valid values: mac, hostname, ip.
DhcpServerAccessList string
Enable/disable DHCP snooping server access list. Valid values: enable, disable.
DhcpSnoopClientDbExp int
Expiry time for DHCP snooping server database entries (300 - 259200 sec, default = 86400 sec).
DhcpSnoopClientReq string
Client DHCP packet broadcast mode. Valid values: drop-untrusted, forward-untrusted.
DhcpSnoopDbPerPortLearnLimit int
Per Interface dhcp-server entries learn limit (0 - 1024, default = 64).
DisableDiscoveries []GlobalDisableDiscoveryArgs
Prevent this FortiSwitch from discovering. The structure of disable_discovery block is documented below.
DynamicSortSubtable string
Sort sub-tables, please do not set this parameter when configuring static sub-tables. Options: [ false, true, natural, alphabetical ]. false: Default value, do not sort tables; true/natural: sort tables in natural order. For example: [ a10, a2 ] -> [ a2, a10 ]; alphabetical: sort tables in alphabetical order. For example: [ a10, a2 ] -> [ a10, a2 ].
FipsEnforce string
Enable/disable enforcement of FIPS on managed FortiSwitch devices. Valid values: disable, enable.
FirmwareProvisionOnAuthorization string
Enable/disable automatic provisioning of latest firmware on authorization. Valid values: enable, disable.
GetAllTables string
Get all sub-tables including unconfigured tables. Do not set this variable to true if you configure sub-table in another resource, otherwise, conflicts and overwrite will occur. Options: [ false, true ]. false: Default value, do not get unconfigured tables; true: get all tables including unconfigured tables.
HttpsImagePush string
Enable/disable image push to FortiSwitch using HTTPS. Valid values: enable, disable.
LogMacLimitViolations string
Enable/disable logs for Learning Limit Violations. Valid values: enable, disable.
MacAgingInterval int
Time after which an inactive MAC is aged out (10 - 1000000 sec, default = 300, 0 = disable).
MacEventLogging string
Enable/disable MAC address event logging. Valid values: enable, disable.
MacRetentionPeriod int
Time in hours after which an inactive MAC is removed from client DB (0 = aged out based on mac-aging-interval).
MacViolationTimer int
Set timeout for Learning Limit Violations (0 = disabled).
QuarantineMode string
Quarantine mode. Valid values: by-vlan, by-redirect.
SnDnsResolution string
Enable/disable DNS resolution of the FortiSwitch unit's IP address by use of its serial number. Valid values: enable, disable.
UpdateUserDevice string
Control which sources update the device user list. Valid values: mac-cache, lldp, dhcp-snooping, l2-db, l3-db.
Vdomparam Changes to this property will trigger replacement. string
Specifies the vdom to which the resource will be applied when the FortiGate unit is running in VDOM mode. Only one vdom can be specified. If you want to inherit the vdom configuration of the provider, please do not set this parameter.
VlanAllMode string
VLAN configuration mode, user-defined-vlans or all-possible-vlans. Valid values: all, defined.
VlanIdentity string
Identity of the VLAN. Commonly used for RADIUS Tunnel-Private-Group-Id. Valid values: description, name.
VlanOptimization string
FortiLink VLAN optimization. Valid values: enable, disable.
allowMultipleInterfaces String
Enable/disable multiple FortiLink interfaces for redundant connections between a managed FortiSwitch and FortiGate. Valid values: enable, disable.
bounceQuarantinedLink String
Enable/disable bouncing (administratively bring the link down, up) of a switch port where a quarantined device was seen last. Helps to re-initiate the DHCP process for a device. Valid values: disable, enable.
customCommands List<GlobalCustomCommand>
List of custom commands to be pushed to all FortiSwitches in the VDOM. The structure of custom_command block is documented below.
defaultVirtualSwitchVlan String
Default VLAN for ports when added to the virtual-switch.
dhcpOption82CircuitId String
List the parameters to be included to inform about client identification. Valid values: intfname, vlan, hostname, mode, description.
dhcpOption82Format String
DHCP option-82 format string. Valid values: ascii, legacy.
dhcpOption82RemoteId String
List the parameters to be included to inform about client identification. Valid values: mac, hostname, ip.
dhcpServerAccessList String
Enable/disable DHCP snooping server access list. Valid values: enable, disable.
dhcpSnoopClientDbExp Integer
Expiry time for DHCP snooping server database entries (300 - 259200 sec, default = 86400 sec).
dhcpSnoopClientReq String
Client DHCP packet broadcast mode. Valid values: drop-untrusted, forward-untrusted.
dhcpSnoopDbPerPortLearnLimit Integer
Per Interface dhcp-server entries learn limit (0 - 1024, default = 64).
disableDiscoveries List<GlobalDisableDiscovery>
Prevent this FortiSwitch from discovering. The structure of disable_discovery block is documented below.
dynamicSortSubtable String
Sort sub-tables, please do not set this parameter when configuring static sub-tables. Options: [ false, true, natural, alphabetical ]. false: Default value, do not sort tables; true/natural: sort tables in natural order. For example: [ a10, a2 ] -> [ a2, a10 ]; alphabetical: sort tables in alphabetical order. For example: [ a10, a2 ] -> [ a10, a2 ].
fipsEnforce String
Enable/disable enforcement of FIPS on managed FortiSwitch devices. Valid values: disable, enable.
firmwareProvisionOnAuthorization String
Enable/disable automatic provisioning of latest firmware on authorization. Valid values: enable, disable.
getAllTables String
Get all sub-tables including unconfigured tables. Do not set this variable to true if you configure sub-table in another resource, otherwise, conflicts and overwrite will occur. Options: [ false, true ]. false: Default value, do not get unconfigured tables; true: get all tables including unconfigured tables.
httpsImagePush String
Enable/disable image push to FortiSwitch using HTTPS. Valid values: enable, disable.
logMacLimitViolations String
Enable/disable logs for Learning Limit Violations. Valid values: enable, disable.
macAgingInterval Integer
Time after which an inactive MAC is aged out (10 - 1000000 sec, default = 300, 0 = disable).
macEventLogging String
Enable/disable MAC address event logging. Valid values: enable, disable.
macRetentionPeriod Integer
Time in hours after which an inactive MAC is removed from client DB (0 = aged out based on mac-aging-interval).
macViolationTimer Integer
Set timeout for Learning Limit Violations (0 = disabled).
quarantineMode String
Quarantine mode. Valid values: by-vlan, by-redirect.
snDnsResolution String
Enable/disable DNS resolution of the FortiSwitch unit's IP address by use of its serial number. Valid values: enable, disable.
updateUserDevice String
Control which sources update the device user list. Valid values: mac-cache, lldp, dhcp-snooping, l2-db, l3-db.
vdomparam Changes to this property will trigger replacement. String
Specifies the vdom to which the resource will be applied when the FortiGate unit is running in VDOM mode. Only one vdom can be specified. If you want to inherit the vdom configuration of the provider, please do not set this parameter.
vlanAllMode String
VLAN configuration mode, user-defined-vlans or all-possible-vlans. Valid values: all, defined.
vlanIdentity String
Identity of the VLAN. Commonly used for RADIUS Tunnel-Private-Group-Id. Valid values: description, name.
vlanOptimization String
FortiLink VLAN optimization. Valid values: enable, disable.
allowMultipleInterfaces string
Enable/disable multiple FortiLink interfaces for redundant connections between a managed FortiSwitch and FortiGate. Valid values: enable, disable.
bounceQuarantinedLink string
Enable/disable bouncing (administratively bring the link down, up) of a switch port where a quarantined device was seen last. Helps to re-initiate the DHCP process for a device. Valid values: disable, enable.
customCommands GlobalCustomCommand[]
List of custom commands to be pushed to all FortiSwitches in the VDOM. The structure of custom_command block is documented below.
defaultVirtualSwitchVlan string
Default VLAN for ports when added to the virtual-switch.
dhcpOption82CircuitId string
List the parameters to be included to inform about client identification. Valid values: intfname, vlan, hostname, mode, description.
dhcpOption82Format string
DHCP option-82 format string. Valid values: ascii, legacy.
dhcpOption82RemoteId string
List the parameters to be included to inform about client identification. Valid values: mac, hostname, ip.
dhcpServerAccessList string
Enable/disable DHCP snooping server access list. Valid values: enable, disable.
dhcpSnoopClientDbExp number
Expiry time for DHCP snooping server database entries (300 - 259200 sec, default = 86400 sec).
dhcpSnoopClientReq string
Client DHCP packet broadcast mode. Valid values: drop-untrusted, forward-untrusted.
dhcpSnoopDbPerPortLearnLimit number
Per Interface dhcp-server entries learn limit (0 - 1024, default = 64).
disableDiscoveries GlobalDisableDiscovery[]
Prevent this FortiSwitch from discovering. The structure of disable_discovery block is documented below.
dynamicSortSubtable string
Sort sub-tables, please do not set this parameter when configuring static sub-tables. Options: [ false, true, natural, alphabetical ]. false: Default value, do not sort tables; true/natural: sort tables in natural order. For example: [ a10, a2 ] -> [ a2, a10 ]; alphabetical: sort tables in alphabetical order. For example: [ a10, a2 ] -> [ a10, a2 ].
fipsEnforce string
Enable/disable enforcement of FIPS on managed FortiSwitch devices. Valid values: disable, enable.
firmwareProvisionOnAuthorization string
Enable/disable automatic provisioning of latest firmware on authorization. Valid values: enable, disable.
getAllTables string
Get all sub-tables including unconfigured tables. Do not set this variable to true if you configure sub-table in another resource, otherwise, conflicts and overwrite will occur. Options: [ false, true ]. false: Default value, do not get unconfigured tables; true: get all tables including unconfigured tables.
httpsImagePush string
Enable/disable image push to FortiSwitch using HTTPS. Valid values: enable, disable.
logMacLimitViolations string
Enable/disable logs for Learning Limit Violations. Valid values: enable, disable.
macAgingInterval number
Time after which an inactive MAC is aged out (10 - 1000000 sec, default = 300, 0 = disable).
macEventLogging string
Enable/disable MAC address event logging. Valid values: enable, disable.
macRetentionPeriod number
Time in hours after which an inactive MAC is removed from client DB (0 = aged out based on mac-aging-interval).
macViolationTimer number
Set timeout for Learning Limit Violations (0 = disabled).
quarantineMode string
Quarantine mode. Valid values: by-vlan, by-redirect.
snDnsResolution string
Enable/disable DNS resolution of the FortiSwitch unit's IP address by use of its serial number. Valid values: enable, disable.
updateUserDevice string
Control which sources update the device user list. Valid values: mac-cache, lldp, dhcp-snooping, l2-db, l3-db.
vdomparam Changes to this property will trigger replacement. string
Specifies the vdom to which the resource will be applied when the FortiGate unit is running in VDOM mode. Only one vdom can be specified. If you want to inherit the vdom configuration of the provider, please do not set this parameter.
vlanAllMode string
VLAN configuration mode, user-defined-vlans or all-possible-vlans. Valid values: all, defined.
vlanIdentity string
Identity of the VLAN. Commonly used for RADIUS Tunnel-Private-Group-Id. Valid values: description, name.
vlanOptimization string
FortiLink VLAN optimization. Valid values: enable, disable.
allow_multiple_interfaces str
Enable/disable multiple FortiLink interfaces for redundant connections between a managed FortiSwitch and FortiGate. Valid values: enable, disable.
bounce_quarantined_link str
Enable/disable bouncing (administratively bring the link down, up) of a switch port where a quarantined device was seen last. Helps to re-initiate the DHCP process for a device. Valid values: disable, enable.
custom_commands Sequence[GlobalCustomCommandArgs]
List of custom commands to be pushed to all FortiSwitches in the VDOM. The structure of custom_command block is documented below.
default_virtual_switch_vlan str
Default VLAN for ports when added to the virtual-switch.
dhcp_option82_circuit_id str
List the parameters to be included to inform about client identification. Valid values: intfname, vlan, hostname, mode, description.
dhcp_option82_format str
DHCP option-82 format string. Valid values: ascii, legacy.
dhcp_option82_remote_id str
List the parameters to be included to inform about client identification. Valid values: mac, hostname, ip.
dhcp_server_access_list str
Enable/disable DHCP snooping server access list. Valid values: enable, disable.
dhcp_snoop_client_db_exp int
Expiry time for DHCP snooping server database entries (300 - 259200 sec, default = 86400 sec).
dhcp_snoop_client_req str
Client DHCP packet broadcast mode. Valid values: drop-untrusted, forward-untrusted.
dhcp_snoop_db_per_port_learn_limit int
Per Interface dhcp-server entries learn limit (0 - 1024, default = 64).
disable_discoveries Sequence[GlobalDisableDiscoveryArgs]
Prevent this FortiSwitch from discovering. The structure of disable_discovery block is documented below.
dynamic_sort_subtable str
Sort sub-tables, please do not set this parameter when configuring static sub-tables. Options: [ false, true, natural, alphabetical ]. false: Default value, do not sort tables; true/natural: sort tables in natural order. For example: [ a10, a2 ] -> [ a2, a10 ]; alphabetical: sort tables in alphabetical order. For example: [ a10, a2 ] -> [ a10, a2 ].
fips_enforce str
Enable/disable enforcement of FIPS on managed FortiSwitch devices. Valid values: disable, enable.
firmware_provision_on_authorization str
Enable/disable automatic provisioning of latest firmware on authorization. Valid values: enable, disable.
get_all_tables str
Get all sub-tables including unconfigured tables. Do not set this variable to true if you configure sub-table in another resource, otherwise, conflicts and overwrite will occur. Options: [ false, true ]. false: Default value, do not get unconfigured tables; true: get all tables including unconfigured tables.
https_image_push str
Enable/disable image push to FortiSwitch using HTTPS. Valid values: enable, disable.
log_mac_limit_violations str
Enable/disable logs for Learning Limit Violations. Valid values: enable, disable.
mac_aging_interval int
Time after which an inactive MAC is aged out (10 - 1000000 sec, default = 300, 0 = disable).
mac_event_logging str
Enable/disable MAC address event logging. Valid values: enable, disable.
mac_retention_period int
Time in hours after which an inactive MAC is removed from client DB (0 = aged out based on mac-aging-interval).
mac_violation_timer int
Set timeout for Learning Limit Violations (0 = disabled).
quarantine_mode str
Quarantine mode. Valid values: by-vlan, by-redirect.
sn_dns_resolution str
Enable/disable DNS resolution of the FortiSwitch unit's IP address by use of its serial number. Valid values: enable, disable.
update_user_device str
Control which sources update the device user list. Valid values: mac-cache, lldp, dhcp-snooping, l2-db, l3-db.
vdomparam Changes to this property will trigger replacement. str
Specifies the vdom to which the resource will be applied when the FortiGate unit is running in VDOM mode. Only one vdom can be specified. If you want to inherit the vdom configuration of the provider, please do not set this parameter.
vlan_all_mode str
VLAN configuration mode, user-defined-vlans or all-possible-vlans. Valid values: all, defined.
vlan_identity str
Identity of the VLAN. Commonly used for RADIUS Tunnel-Private-Group-Id. Valid values: description, name.
vlan_optimization str
FortiLink VLAN optimization. Valid values: enable, disable.
allowMultipleInterfaces String
Enable/disable multiple FortiLink interfaces for redundant connections between a managed FortiSwitch and FortiGate. Valid values: enable, disable.
bounceQuarantinedLink String
Enable/disable bouncing (administratively bring the link down, up) of a switch port where a quarantined device was seen last. Helps to re-initiate the DHCP process for a device. Valid values: disable, enable.
customCommands List<Property Map>
List of custom commands to be pushed to all FortiSwitches in the VDOM. The structure of custom_command block is documented below.
defaultVirtualSwitchVlan String
Default VLAN for ports when added to the virtual-switch.
dhcpOption82CircuitId String
List the parameters to be included to inform about client identification. Valid values: intfname, vlan, hostname, mode, description.
dhcpOption82Format String
DHCP option-82 format string. Valid values: ascii, legacy.
dhcpOption82RemoteId String
List the parameters to be included to inform about client identification. Valid values: mac, hostname, ip.
dhcpServerAccessList String
Enable/disable DHCP snooping server access list. Valid values: enable, disable.
dhcpSnoopClientDbExp Number
Expiry time for DHCP snooping server database entries (300 - 259200 sec, default = 86400 sec).
dhcpSnoopClientReq String
Client DHCP packet broadcast mode. Valid values: drop-untrusted, forward-untrusted.
dhcpSnoopDbPerPortLearnLimit Number
Per Interface dhcp-server entries learn limit (0 - 1024, default = 64).
disableDiscoveries List<Property Map>
Prevent this FortiSwitch from discovering. The structure of disable_discovery block is documented below.
dynamicSortSubtable String
Sort sub-tables, please do not set this parameter when configuring static sub-tables. Options: [ false, true, natural, alphabetical ]. false: Default value, do not sort tables; true/natural: sort tables in natural order. For example: [ a10, a2 ] -> [ a2, a10 ]; alphabetical: sort tables in alphabetical order. For example: [ a10, a2 ] -> [ a10, a2 ].
fipsEnforce String
Enable/disable enforcement of FIPS on managed FortiSwitch devices. Valid values: disable, enable.
firmwareProvisionOnAuthorization String
Enable/disable automatic provisioning of latest firmware on authorization. Valid values: enable, disable.
getAllTables String
Get all sub-tables including unconfigured tables. Do not set this variable to true if you configure sub-table in another resource, otherwise, conflicts and overwrite will occur. Options: [ false, true ]. false: Default value, do not get unconfigured tables; true: get all tables including unconfigured tables.
httpsImagePush String
Enable/disable image push to FortiSwitch using HTTPS. Valid values: enable, disable.
logMacLimitViolations String
Enable/disable logs for Learning Limit Violations. Valid values: enable, disable.
macAgingInterval Number
Time after which an inactive MAC is aged out (10 - 1000000 sec, default = 300, 0 = disable).
macEventLogging String
Enable/disable MAC address event logging. Valid values: enable, disable.
macRetentionPeriod Number
Time in hours after which an inactive MAC is removed from client DB (0 = aged out based on mac-aging-interval).
macViolationTimer Number
Set timeout for Learning Limit Violations (0 = disabled).
quarantineMode String
Quarantine mode. Valid values: by-vlan, by-redirect.
snDnsResolution String
Enable/disable DNS resolution of the FortiSwitch unit's IP address by use of its serial number. Valid values: enable, disable.
updateUserDevice String
Control which sources update the device user list. Valid values: mac-cache, lldp, dhcp-snooping, l2-db, l3-db.
vdomparam Changes to this property will trigger replacement. String
Specifies the vdom to which the resource will be applied when the FortiGate unit is running in VDOM mode. Only one vdom can be specified. If you want to inherit the vdom configuration of the provider, please do not set this parameter.
vlanAllMode String
VLAN configuration mode, user-defined-vlans or all-possible-vlans. Valid values: all, defined.
vlanIdentity String
Identity of the VLAN. Commonly used for RADIUS Tunnel-Private-Group-Id. Valid values: description, name.
vlanOptimization String
FortiLink VLAN optimization. Valid values: enable, disable.

Supporting Types

GlobalCustomCommand
, GlobalCustomCommandArgs

CommandEntry string
List of FortiSwitch commands.
CommandName string
Name of custom command to push to all FortiSwitches in VDOM.
CommandEntry string
List of FortiSwitch commands.
CommandName string
Name of custom command to push to all FortiSwitches in VDOM.
commandEntry String
List of FortiSwitch commands.
commandName String
Name of custom command to push to all FortiSwitches in VDOM.
commandEntry string
List of FortiSwitch commands.
commandName string
Name of custom command to push to all FortiSwitches in VDOM.
command_entry str
List of FortiSwitch commands.
command_name str
Name of custom command to push to all FortiSwitches in VDOM.
commandEntry String
List of FortiSwitch commands.
commandName String
Name of custom command to push to all FortiSwitches in VDOM.

GlobalDisableDiscovery
, GlobalDisableDiscoveryArgs

Name string
Managed device ID.
Name string
Managed device ID.
name String
Managed device ID.
name string
Managed device ID.
name str
Managed device ID.
name String
Managed device ID.

Import

SwitchController Global can be imported using any of these accepted formats:

$ pulumi import fortios:switchcontroller/global:Global labelname SwitchControllerGlobal
Copy

If you do not want to import arguments of block:

$ export “FORTIOS_IMPORT_TABLE”=“false”

$ pulumi import fortios:switchcontroller/global:Global labelname SwitchControllerGlobal
Copy

$ unset “FORTIOS_IMPORT_TABLE”

To learn more about importing existing cloud resources, see Importing resources.

Package Details

Repository
fortios pulumiverse/pulumi-fortios
License
Apache-2.0
Notes
This Pulumi package is based on the fortios Terraform Provider.