1. Packages
  2. Zscaler Internet Access (ZIA)
  3. API Docs
  4. BandwidthControlRule
Viewing docs for pulumi-resource-zia v1.3.8
published on Friday, Mar 13, 2026 by Zscaler
zia logo
Viewing docs for pulumi-resource-zia v1.3.8
published on Friday, Mar 13, 2026 by Zscaler

    The zia_bandwidth_control_rule resource manages bandwidth control rules in the Zscaler Internet Access (ZIA) cloud service. Bandwidth control rules allow administrators to define minimum and maximum bandwidth limits for specific traffic, locations, and time windows to ensure quality of service across the network.

    For more information, see the ZIA Bandwidth Control documentation.

    Example Usage

    Basic Bandwidth Control Rule

    Example coming soon!

    Example coming soon!

    Example coming soon!

    import * as zia from "@bdzscaler/pulumi-zia";
    
    const example = new zia.BandwidthControlRule("example", {
        name: "Example Bandwidth Control Rule",
        description: "Limit streaming bandwidth",
        order: 1,
        state: "ENABLED",
        maxBandwidth: 50,
        protocols: ["ANY_RULE"],
    });
    
    import zscaler_pulumi_zia as zia
    
    example = zia.BandwidthControlRule("example",
        name="Example Bandwidth Control Rule",
        description="Limit streaming bandwidth",
        order=1,
        state="ENABLED",
        max_bandwidth=50,
        protocols=["ANY_RULE"],
    )
    
    resources:
      example:
        type: zia:BandwidthControlRule
        properties:
          name: Example Bandwidth Control Rule
          description: Limit streaming bandwidth
          order: 1
          state: ENABLED
          maxBandwidth: 50
          protocols:
            - ANY_RULE
    

    Create BandwidthControlRule Resource

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

    Constructor syntax

    new BandwidthControlRule(name: string, args: BandwidthControlRuleArgs, opts?: CustomResourceOptions);
    @overload
    def BandwidthControlRule(resource_name: str,
                             args: BandwidthControlRuleArgs,
                             opts: Optional[ResourceOptions] = None)
    
    @overload
    def BandwidthControlRule(resource_name: str,
                             opts: Optional[ResourceOptions] = None,
                             name: Optional[str] = None,
                             order: Optional[int] = None,
                             min_bandwidth: Optional[int] = None,
                             location_groups: Optional[Sequence[int]] = None,
                             locations: Optional[Sequence[int]] = None,
                             max_bandwidth: Optional[int] = None,
                             bandwidth_classes: Optional[Sequence[int]] = None,
                             labels: Optional[Sequence[int]] = None,
                             description: Optional[str] = None,
                             protocols: Optional[Sequence[str]] = None,
                             rank: Optional[int] = None,
                             state: Optional[str] = None,
                             time_windows: Optional[Sequence[int]] = None)
    func NewBandwidthControlRule(ctx *Context, name string, args BandwidthControlRuleArgs, opts ...ResourceOption) (*BandwidthControlRule, error)
    public BandwidthControlRule(string name, BandwidthControlRuleArgs args, CustomResourceOptions? opts = null)
    public BandwidthControlRule(String name, BandwidthControlRuleArgs args)
    public BandwidthControlRule(String name, BandwidthControlRuleArgs args, CustomResourceOptions options)
    
    type: zia:BandwidthControlRule
    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 BandwidthControlRuleArgs
    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 BandwidthControlRuleArgs
    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 BandwidthControlRuleArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args BandwidthControlRuleArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args BandwidthControlRuleArgs
    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 bandwidthControlRuleResource = new Zia.BandwidthControlRule("bandwidthControlRuleResource", new()
    {
        Name = "string",
        Order = 0,
        MinBandwidth = 0,
        LocationGroups = new[]
        {
            0,
        },
        Locations = new[]
        {
            0,
        },
        MaxBandwidth = 0,
        BandwidthClasses = new[]
        {
            0,
        },
        Labels = new[]
        {
            0,
        },
        Description = "string",
        Protocols = new[]
        {
            "string",
        },
        Rank = 0,
        State = "string",
        TimeWindows = new[]
        {
            0,
        },
    });
    
    example, err := zia.NewBandwidthControlRule(ctx, "bandwidthControlRuleResource", &zia.BandwidthControlRuleArgs{
    	Name:         pulumi.String("string"),
    	Order:        pulumi.Int(0),
    	MinBandwidth: pulumi.Int(0),
    	LocationGroups: pulumi.IntArray{
    		pulumi.Int(0),
    	},
    	Locations: pulumi.IntArray{
    		pulumi.Int(0),
    	},
    	MaxBandwidth: pulumi.Int(0),
    	BandwidthClasses: pulumi.IntArray{
    		pulumi.Int(0),
    	},
    	Labels: pulumi.IntArray{
    		pulumi.Int(0),
    	},
    	Description: pulumi.String("string"),
    	Protocols: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Rank:  pulumi.Int(0),
    	State: pulumi.String("string"),
    	TimeWindows: pulumi.IntArray{
    		pulumi.Int(0),
    	},
    })
    
    var bandwidthControlRuleResource = new BandwidthControlRule("bandwidthControlRuleResource", BandwidthControlRuleArgs.builder()
        .name("string")
        .order(0)
        .minBandwidth(0)
        .locationGroups(0)
        .locations(0)
        .maxBandwidth(0)
        .bandwidthClasses(0)
        .labels(0)
        .description("string")
        .protocols("string")
        .rank(0)
        .state("string")
        .timeWindows(0)
        .build());
    
    bandwidth_control_rule_resource = zia.BandwidthControlRule("bandwidthControlRuleResource",
        name="string",
        order=0,
        min_bandwidth=0,
        location_groups=[0],
        locations=[0],
        max_bandwidth=0,
        bandwidth_classes=[0],
        labels=[0],
        description="string",
        protocols=["string"],
        rank=0,
        state="string",
        time_windows=[0])
    
    const bandwidthControlRuleResource = new zia.BandwidthControlRule("bandwidthControlRuleResource", {
        name: "string",
        order: 0,
        minBandwidth: 0,
        locationGroups: [0],
        locations: [0],
        maxBandwidth: 0,
        bandwidthClasses: [0],
        labels: [0],
        description: "string",
        protocols: ["string"],
        rank: 0,
        state: "string",
        timeWindows: [0],
    });
    
    type: zia:BandwidthControlRule
    properties:
        bandwidthClasses:
            - 0
        description: string
        labels:
            - 0
        locationGroups:
            - 0
        locations:
            - 0
        maxBandwidth: 0
        minBandwidth: 0
        name: string
        order: 0
        protocols:
            - string
        rank: 0
        state: string
        timeWindows:
            - 0
    

    BandwidthControlRule 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 BandwidthControlRule resource accepts the following input properties:

    Name string
    The name of the bandwidth control rule. Must be unique.
    Order int
    The order of execution of the rule with respect to other bandwidth control rules.
    BandwidthClasses List<int>
    IDs of bandwidth classes associated with this rule.
    Description string
    Additional information about the bandwidth control rule.
    Labels List<int>
    IDs of labels associated with the bandwidth control rule.
    LocationGroups List<int>
    IDs of location groups for which the rule must be applied.
    Locations List<int>
    IDs of locations for which the rule must be applied.
    MaxBandwidth int
    The maximum bandwidth percentage allowed. Valid range: 0-100.
    MinBandwidth int
    The minimum bandwidth percentage allocated. Valid range: 0-100.
    Protocols List<string>
    Protocols to which the rule applies. Valid values: ANY_RULE, TCP_RULE, UDP_RULE, SSL_RULE.
    Rank int
    Admin rank of the bandwidth control rule. Valid values: 0-7. Default: 7.
    State string
    Rule state. Valid values: ENABLED, DISABLED.
    TimeWindows List<int>
    IDs of time intervals during which the rule must be enforced.
    Name string
    The name of the bandwidth control rule. Must be unique.
    Order int
    The order of execution of the rule with respect to other bandwidth control rules.
    BandwidthClasses []int
    IDs of bandwidth classes associated with this rule.
    Description string
    Additional information about the bandwidth control rule.
    Labels []int
    IDs of labels associated with the bandwidth control rule.
    LocationGroups []int
    IDs of location groups for which the rule must be applied.
    Locations []int
    IDs of locations for which the rule must be applied.
    MaxBandwidth int
    The maximum bandwidth percentage allowed. Valid range: 0-100.
    MinBandwidth int
    The minimum bandwidth percentage allocated. Valid range: 0-100.
    Protocols []string
    Protocols to which the rule applies. Valid values: ANY_RULE, TCP_RULE, UDP_RULE, SSL_RULE.
    Rank int
    Admin rank of the bandwidth control rule. Valid values: 0-7. Default: 7.
    State string
    Rule state. Valid values: ENABLED, DISABLED.
    TimeWindows []int
    IDs of time intervals during which the rule must be enforced.
    name String
    The name of the bandwidth control rule. Must be unique.
    order Integer
    The order of execution of the rule with respect to other bandwidth control rules.
    bandwidthClasses List<Integer>
    IDs of bandwidth classes associated with this rule.
    description String
    Additional information about the bandwidth control rule.
    labels List<Integer>
    IDs of labels associated with the bandwidth control rule.
    locationGroups List<Integer>
    IDs of location groups for which the rule must be applied.
    locations List<Integer>
    IDs of locations for which the rule must be applied.
    maxBandwidth Integer
    The maximum bandwidth percentage allowed. Valid range: 0-100.
    minBandwidth Integer
    The minimum bandwidth percentage allocated. Valid range: 0-100.
    protocols List<String>
    Protocols to which the rule applies. Valid values: ANY_RULE, TCP_RULE, UDP_RULE, SSL_RULE.
    rank Integer
    Admin rank of the bandwidth control rule. Valid values: 0-7. Default: 7.
    state String
    Rule state. Valid values: ENABLED, DISABLED.
    timeWindows List<Integer>
    IDs of time intervals during which the rule must be enforced.
    name string
    The name of the bandwidth control rule. Must be unique.
    order number
    The order of execution of the rule with respect to other bandwidth control rules.
    bandwidthClasses number[]
    IDs of bandwidth classes associated with this rule.
    description string
    Additional information about the bandwidth control rule.
    labels number[]
    IDs of labels associated with the bandwidth control rule.
    locationGroups number[]
    IDs of location groups for which the rule must be applied.
    locations number[]
    IDs of locations for which the rule must be applied.
    maxBandwidth number
    The maximum bandwidth percentage allowed. Valid range: 0-100.
    minBandwidth number
    The minimum bandwidth percentage allocated. Valid range: 0-100.
    protocols string[]
    Protocols to which the rule applies. Valid values: ANY_RULE, TCP_RULE, UDP_RULE, SSL_RULE.
    rank number
    Admin rank of the bandwidth control rule. Valid values: 0-7. Default: 7.
    state string
    Rule state. Valid values: ENABLED, DISABLED.
    timeWindows number[]
    IDs of time intervals during which the rule must be enforced.
    name str
    The name of the bandwidth control rule. Must be unique.
    order int
    The order of execution of the rule with respect to other bandwidth control rules.
    bandwidth_classes Sequence[int]
    IDs of bandwidth classes associated with this rule.
    description str
    Additional information about the bandwidth control rule.
    labels Sequence[int]
    IDs of labels associated with the bandwidth control rule.
    location_groups Sequence[int]
    IDs of location groups for which the rule must be applied.
    locations Sequence[int]
    IDs of locations for which the rule must be applied.
    max_bandwidth int
    The maximum bandwidth percentage allowed. Valid range: 0-100.
    min_bandwidth int
    The minimum bandwidth percentage allocated. Valid range: 0-100.
    protocols Sequence[str]
    Protocols to which the rule applies. Valid values: ANY_RULE, TCP_RULE, UDP_RULE, SSL_RULE.
    rank int
    Admin rank of the bandwidth control rule. Valid values: 0-7. Default: 7.
    state str
    Rule state. Valid values: ENABLED, DISABLED.
    time_windows Sequence[int]
    IDs of time intervals during which the rule must be enforced.
    name String
    The name of the bandwidth control rule. Must be unique.
    order Number
    The order of execution of the rule with respect to other bandwidth control rules.
    bandwidthClasses List<Number>
    IDs of bandwidth classes associated with this rule.
    description String
    Additional information about the bandwidth control rule.
    labels List<Number>
    IDs of labels associated with the bandwidth control rule.
    locationGroups List<Number>
    IDs of location groups for which the rule must be applied.
    locations List<Number>
    IDs of locations for which the rule must be applied.
    maxBandwidth Number
    The maximum bandwidth percentage allowed. Valid range: 0-100.
    minBandwidth Number
    The minimum bandwidth percentage allocated. Valid range: 0-100.
    protocols List<String>
    Protocols to which the rule applies. Valid values: ANY_RULE, TCP_RULE, UDP_RULE, SSL_RULE.
    rank Number
    Admin rank of the bandwidth control rule. Valid values: 0-7. Default: 7.
    state String
    Rule state. Valid values: ENABLED, DISABLED.
    timeWindows List<Number>
    IDs of time intervals during which the rule must be enforced.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    RuleId int
    The system-generated ID of the bandwidth control rule.
    Id string
    The provider-assigned unique ID for this managed resource.
    RuleId int
    The system-generated ID of the bandwidth control rule.
    id String
    The provider-assigned unique ID for this managed resource.
    ruleId Integer
    The system-generated ID of the bandwidth control rule.
    id string
    The provider-assigned unique ID for this managed resource.
    ruleId number
    The system-generated ID of the bandwidth control rule.
    id str
    The provider-assigned unique ID for this managed resource.
    rule_id int
    The system-generated ID of the bandwidth control rule.
    id String
    The provider-assigned unique ID for this managed resource.
    ruleId Number
    The system-generated ID of the bandwidth control rule.

    Import

    An existing Bandwidth Control Rule can be imported using its resource ID, e.g.

    $ pulumi import zia:index:BandwidthControlRule example 12345
    

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

    Package Details

    Repository
    zia zscaler/pulumi-zia
    License
    zia logo
    Viewing docs for pulumi-resource-zia v1.3.8
    published on Friday, Mar 13, 2026 by Zscaler
      Try Pulumi Cloud free. Your team will thank you.