1. Packages
  2. Zscaler Internet Access (ZIA)
  3. API Docs
  4. BandwidthControlClasses
Zscaler Internet Access v1.2.0 published on Friday, Feb 20, 2026 by Zscaler
zia logo
Zscaler Internet Access v1.2.0 published on Friday, Feb 20, 2026 by Zscaler

    Use the zia_bandwidth_classes resource allows the creation and management of ZIA Bandwidth Control classes in the Zscaler Internet Access cloud or via the API.

    Example Usage

    By Name

    
    resource "zia_bandwidth_classes" "this" {
        name = "Gen_AI_Classes"
        web_applications = [
            "ACADEMICGPT",
            "AD_CREATIVES",
            "AGENTGPT",
            "AI_ART_GENERATOR",
            "AI_CHAT_ROBOT",
            "AI_COPYWRITING_TREASURE",
            "AI_FOR_SEO",
            "ONE_MIN_AI"
        ]
        urls = ["chatgpt.com", "chatgpt1.com"]
        url_categories = [
            "AI_ML_APPS",
            "GENERAL_AI_ML"
        ]
    }
    

    Create BandwidthControlClasses Resource

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

    Constructor syntax

    new BandwidthControlClasses(name: string, args?: BandwidthControlClassesArgs, opts?: CustomResourceOptions);
    @overload
    def BandwidthControlClasses(resource_name: str,
                                args: Optional[BandwidthControlClassesArgs] = None,
                                opts: Optional[ResourceOptions] = None)
    
    @overload
    def BandwidthControlClasses(resource_name: str,
                                opts: Optional[ResourceOptions] = None,
                                name: Optional[str] = None,
                                url_categories: Optional[Sequence[str]] = None,
                                urls: Optional[Sequence[str]] = None,
                                web_applications: Optional[Sequence[str]] = None)
    func NewBandwidthControlClasses(ctx *Context, name string, args *BandwidthControlClassesArgs, opts ...ResourceOption) (*BandwidthControlClasses, error)
    public BandwidthControlClasses(string name, BandwidthControlClassesArgs? args = null, CustomResourceOptions? opts = null)
    public BandwidthControlClasses(String name, BandwidthControlClassesArgs args)
    public BandwidthControlClasses(String name, BandwidthControlClassesArgs args, CustomResourceOptions options)
    
    type: zia:BandwidthControlClasses
    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 BandwidthControlClassesArgs
    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 BandwidthControlClassesArgs
    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 BandwidthControlClassesArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args BandwidthControlClassesArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args BandwidthControlClassesArgs
    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 bandwidthControlClassesResource = new Zia.BandwidthControlClasses("bandwidthControlClassesResource", new()
    {
        Name = "string",
        UrlCategories = new[]
        {
            "string",
        },
        Urls = new[]
        {
            "string",
        },
        WebApplications = new[]
        {
            "string",
        },
    });
    
    example, err := zia.NewBandwidthControlClasses(ctx, "bandwidthControlClassesResource", &zia.BandwidthControlClassesArgs{
    	Name: pulumi.String("string"),
    	UrlCategories: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Urls: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	WebApplications: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    })
    
    var bandwidthControlClassesResource = new BandwidthControlClasses("bandwidthControlClassesResource", BandwidthControlClassesArgs.builder()
        .name("string")
        .urlCategories("string")
        .urls("string")
        .webApplications("string")
        .build());
    
    bandwidth_control_classes_resource = zia.BandwidthControlClasses("bandwidthControlClassesResource",
        name="string",
        url_categories=["string"],
        urls=["string"],
        web_applications=["string"])
    
    const bandwidthControlClassesResource = new zia.BandwidthControlClasses("bandwidthControlClassesResource", {
        name: "string",
        urlCategories: ["string"],
        urls: ["string"],
        webApplications: ["string"],
    });
    
    type: zia:BandwidthControlClasses
    properties:
        name: string
        urlCategories:
            - string
        urls:
            - string
        webApplications:
            - string
    

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

    Name string
    Name of the bandwidth class
    UrlCategories List<string>
    (List of strings) The URL categories to add to the bandwidth class. Use the data source zia.URLCategories to retrieve the available categories or visit the Help Portal
    Urls List<string>
    (List of strings) The URLs included in the bandwidth class. You can include multiple entries.
    WebApplications List<string>
    (List of strings) The web conferencing applications included in the bandwidth class. Use the data source zia.getCloudApplications to retrieve the available applications or visit the Help Portal
    Name string
    Name of the bandwidth class
    UrlCategories []string
    (List of strings) The URL categories to add to the bandwidth class. Use the data source zia.URLCategories to retrieve the available categories or visit the Help Portal
    Urls []string
    (List of strings) The URLs included in the bandwidth class. You can include multiple entries.
    WebApplications []string
    (List of strings) The web conferencing applications included in the bandwidth class. Use the data source zia.getCloudApplications to retrieve the available applications or visit the Help Portal
    name String
    Name of the bandwidth class
    urlCategories List<String>
    (List of strings) The URL categories to add to the bandwidth class. Use the data source zia.URLCategories to retrieve the available categories or visit the Help Portal
    urls List<String>
    (List of strings) The URLs included in the bandwidth class. You can include multiple entries.
    webApplications List<String>
    (List of strings) The web conferencing applications included in the bandwidth class. Use the data source zia.getCloudApplications to retrieve the available applications or visit the Help Portal
    name string
    Name of the bandwidth class
    urlCategories string[]
    (List of strings) The URL categories to add to the bandwidth class. Use the data source zia.URLCategories to retrieve the available categories or visit the Help Portal
    urls string[]
    (List of strings) The URLs included in the bandwidth class. You can include multiple entries.
    webApplications string[]
    (List of strings) The web conferencing applications included in the bandwidth class. Use the data source zia.getCloudApplications to retrieve the available applications or visit the Help Portal
    name str
    Name of the bandwidth class
    url_categories Sequence[str]
    (List of strings) The URL categories to add to the bandwidth class. Use the data source zia.URLCategories to retrieve the available categories or visit the Help Portal
    urls Sequence[str]
    (List of strings) The URLs included in the bandwidth class. You can include multiple entries.
    web_applications Sequence[str]
    (List of strings) The web conferencing applications included in the bandwidth class. Use the data source zia.getCloudApplications to retrieve the available applications or visit the Help Portal
    name String
    Name of the bandwidth class
    urlCategories List<String>
    (List of strings) The URL categories to add to the bandwidth class. Use the data source zia.URLCategories to retrieve the available categories or visit the Help Portal
    urls List<String>
    (List of strings) The URLs included in the bandwidth class. You can include multiple entries.
    webApplications List<String>
    (List of strings) The web conferencing applications included in the bandwidth class. Use the data source zia.getCloudApplications to retrieve the available applications or visit the Help Portal

    Outputs

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

    ClassId int
    Id string
    The provider-assigned unique ID for this managed resource.
    ClassId int
    Id string
    The provider-assigned unique ID for this managed resource.
    classId Integer
    id String
    The provider-assigned unique ID for this managed resource.
    classId number
    id string
    The provider-assigned unique ID for this managed resource.
    class_id int
    id str
    The provider-assigned unique ID for this managed resource.
    classId Number
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing BandwidthControlClasses Resource

    Get an existing BandwidthControlClasses 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?: BandwidthControlClassesState, opts?: CustomResourceOptions): BandwidthControlClasses
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            class_id: Optional[int] = None,
            name: Optional[str] = None,
            url_categories: Optional[Sequence[str]] = None,
            urls: Optional[Sequence[str]] = None,
            web_applications: Optional[Sequence[str]] = None) -> BandwidthControlClasses
    func GetBandwidthControlClasses(ctx *Context, name string, id IDInput, state *BandwidthControlClassesState, opts ...ResourceOption) (*BandwidthControlClasses, error)
    public static BandwidthControlClasses Get(string name, Input<string> id, BandwidthControlClassesState? state, CustomResourceOptions? opts = null)
    public static BandwidthControlClasses get(String name, Output<String> id, BandwidthControlClassesState state, CustomResourceOptions options)
    resources:  _:    type: zia:BandwidthControlClasses    get:      id: ${id}
    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:
    ClassId int
    Name string
    Name of the bandwidth class
    UrlCategories List<string>
    (List of strings) The URL categories to add to the bandwidth class. Use the data source zia.URLCategories to retrieve the available categories or visit the Help Portal
    Urls List<string>
    (List of strings) The URLs included in the bandwidth class. You can include multiple entries.
    WebApplications List<string>
    (List of strings) The web conferencing applications included in the bandwidth class. Use the data source zia.getCloudApplications to retrieve the available applications or visit the Help Portal
    ClassId int
    Name string
    Name of the bandwidth class
    UrlCategories []string
    (List of strings) The URL categories to add to the bandwidth class. Use the data source zia.URLCategories to retrieve the available categories or visit the Help Portal
    Urls []string
    (List of strings) The URLs included in the bandwidth class. You can include multiple entries.
    WebApplications []string
    (List of strings) The web conferencing applications included in the bandwidth class. Use the data source zia.getCloudApplications to retrieve the available applications or visit the Help Portal
    classId Integer
    name String
    Name of the bandwidth class
    urlCategories List<String>
    (List of strings) The URL categories to add to the bandwidth class. Use the data source zia.URLCategories to retrieve the available categories or visit the Help Portal
    urls List<String>
    (List of strings) The URLs included in the bandwidth class. You can include multiple entries.
    webApplications List<String>
    (List of strings) The web conferencing applications included in the bandwidth class. Use the data source zia.getCloudApplications to retrieve the available applications or visit the Help Portal
    classId number
    name string
    Name of the bandwidth class
    urlCategories string[]
    (List of strings) The URL categories to add to the bandwidth class. Use the data source zia.URLCategories to retrieve the available categories or visit the Help Portal
    urls string[]
    (List of strings) The URLs included in the bandwidth class. You can include multiple entries.
    webApplications string[]
    (List of strings) The web conferencing applications included in the bandwidth class. Use the data source zia.getCloudApplications to retrieve the available applications or visit the Help Portal
    class_id int
    name str
    Name of the bandwidth class
    url_categories Sequence[str]
    (List of strings) The URL categories to add to the bandwidth class. Use the data source zia.URLCategories to retrieve the available categories or visit the Help Portal
    urls Sequence[str]
    (List of strings) The URLs included in the bandwidth class. You can include multiple entries.
    web_applications Sequence[str]
    (List of strings) The web conferencing applications included in the bandwidth class. Use the data source zia.getCloudApplications to retrieve the available applications or visit the Help Portal
    classId Number
    name String
    Name of the bandwidth class
    urlCategories List<String>
    (List of strings) The URL categories to add to the bandwidth class. Use the data source zia.URLCategories to retrieve the available categories or visit the Help Portal
    urls List<String>
    (List of strings) The URLs included in the bandwidth class. You can include multiple entries.
    webApplications List<String>
    (List of strings) The web conferencing applications included in the bandwidth class. Use the data source zia.getCloudApplications to retrieve the available applications or visit the Help Portal

    Import

    Zscaler offers a dedicated tool called Zscaler-Terraformer to allow the automated import of ZIA configurations into Terraform-compliant HashiCorp Configuration Language. Visit

    zia_bandwidth_classes can be imported by using <CLASS_ID> or <CLASS_NAME> as the import ID.

    For example:

    $ pulumi import zia:index/bandwidthControlClasses:BandwidthControlClasses this <class_id>
    
    $ pulumi import zia:index/bandwidthControlClasses:BandwidthControlClasses this <"class_name">
    

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

    Package Details

    Repository
    zia zscaler/pulumi-zia
    License
    MIT
    Notes
    This Pulumi package is based on the zia Terraform Provider.
    zia logo
    Zscaler Internet Access v1.2.0 published on Friday, Feb 20, 2026 by Zscaler
      Meet Neo: Your AI Platform Teammate