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

fortios logo
Fortios v0.0.6 published on Tuesday, Jul 9, 2024 by pulumiverse

    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,
    });
    
    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)
    
    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
    	})
    }
    
    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,
        });
    
    });
    
    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());
    
        }
    }
    
    resources:
      trname:
        type: fortios:switchcontroller:Global
        properties:
          allowMultipleInterfaces: disable
          httpsImagePush: disable
          logMacLimitViolations: disable
          macAgingInterval: 332
          macRetentionPeriod: 24
          macViolationTimer: 0
    

    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 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 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 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 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 String
    The unique name of the resource.
    args 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",
    });
    
    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"),
    })
    
    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());
    
    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")
    
    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",
    });
    
    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
    

    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 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 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 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 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 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 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)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    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
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    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
    The unique name of the resulting resource.
    id
    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
    The unique name of the resulting resource.
    id
    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 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 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 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 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 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 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
    

    If you do not want to import arguments of block:

    $ export “FORTIOS_IMPORT_TABLE”=“false”

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

    $ 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.
    fortios logo
    Fortios v0.0.6 published on Tuesday, Jul 9, 2024 by pulumiverse