published on Friday, Mar 13, 2026 by Zscaler
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.
- Bandwidth
Classes 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.
- Location
Groups 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.
- 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 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. - Time
Windows 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.
- Bandwidth
Classes []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.
- Location
Groups []int - IDs of location groups for which the rule must be applied.
- Locations []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 []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. - Time
Windows []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.
- bandwidth
Classes 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.
- location
Groups 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.
- max
Bandwidth Integer - The maximum bandwidth percentage allowed. Valid range: 0-100.
- min
Bandwidth 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. - time
Windows 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.
- bandwidth
Classes 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.
- location
Groups number[] - IDs of location groups for which the rule must be applied.
- locations number[]
- IDs of locations for which the rule must be applied.
- max
Bandwidth number - The maximum bandwidth percentage allowed. Valid range: 0-100.
- min
Bandwidth 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. - time
Windows 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.
- bandwidth
Classes 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.
- location
Groups 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.
- max
Bandwidth Number - The maximum bandwidth percentage allowed. Valid range: 0-100.
- min
Bandwidth 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. - time
Windows 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:
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
published on Friday, Mar 13, 2026 by Zscaler
