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

zia.FwIpDestinationGroup

zia logo
Viewing docs for pulumi-resource-zia v1.3.8
published on Friday, Mar 13, 2026 by Zscaler
Schema (JSON)
zscaler/pulumi-zia

    The zia_fw_ip_destination_group resource manages firewall IP destination groups in the Zscaler Internet Access (ZIA) cloud service. IP destination groups allow you to define groups of destination IP addresses, FQDNs, or countries that can be referenced in firewall filtering rules.

    For more information, see the ZIA Firewall Policies documentation.

    Example Usage

    Basic IP Destination Group

    Example coming soon!

    Example coming soon!

    Example coming soon!

    import * as zia from "@bdzscaler/pulumi-zia";

const example = new zia.FwIpDestinationGroup("example", {
    name: "Example IP Destination Group",
    description: "Group of destination IPs",
    type: "DSTN_IP",
    addresses: ["203.0.113.0/24", "198.51.100.0/24"],
});

    import zscaler_pulumi_zia as zia

example = zia.FwIpDestinationGroup("example",
    name="Example IP Destination Group",
    description="Group of destination IPs",
    type="DSTN_IP",
    addresses=["203.0.113.0/24", "198.51.100.0/24"],
)

    resources:
  example:
    type: zia:FwIpDestinationGroup
    properties:
      name: Example IP Destination Group
      description: Group of destination IPs
      type: DSTN_IP
      addresses:
        - 203.0.113.0/24
        - 198.51.100.0/24

    Create FwIpDestinationGroup Resource

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

    Constructor syntax

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

@overload
def FwIpDestinationGroup(resource_name: str,
                         opts: Optional[ResourceOptions] = None,
                         addresses: Optional[Sequence[str]] = None,
                         countries: Optional[Sequence[str]] = None,
                         description: Optional[str] = None,
                         ip_categories: Optional[Sequence[str]] = None,
                         name: Optional[str] = None,
                         type: Optional[str] = None)
    func NewFwIpDestinationGroup(ctx *Context, name string, args *FwIpDestinationGroupArgs, opts ...ResourceOption) (*FwIpDestinationGroup, error)
    public FwIpDestinationGroup(string name, FwIpDestinationGroupArgs? args = null, CustomResourceOptions? opts = null)
    public FwIpDestinationGroup(String name, FwIpDestinationGroupArgs args)
public FwIpDestinationGroup(String name, FwIpDestinationGroupArgs args, CustomResourceOptions options)

    type: zia:FwIpDestinationGroup
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 FwIpDestinationGroupArgs
    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 FwIpDestinationGroupArgs
    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 FwIpDestinationGroupArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args FwIpDestinationGroupArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args FwIpDestinationGroupArgs
    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 fwIpDestinationGroupResource = new Zia.FwIpDestinationGroup("fwIpDestinationGroupResource", new()
{
    Addresses = new[]
    {
        "string",
    },
    Countries = new[]
    {
        "string",
    },
    Description = "string",
    IpCategories = new[]
    {
        "string",
    },
    Name = "string",
    Type = "string",
});

    example, err := zia.NewFwIpDestinationGroup(ctx, "fwIpDestinationGroupResource", &zia.FwIpDestinationGroupArgs{
	Addresses: pulumi.StringArray{
		pulumi.String("string"),
	},
	Countries: pulumi.StringArray{
		pulumi.String("string"),
	},
	Description: pulumi.String("string"),
	IpCategories: pulumi.StringArray{
		pulumi.String("string"),
	},
	Name: pulumi.String("string"),
	Type: pulumi.String("string"),
})

    var fwIpDestinationGroupResource = new FwIpDestinationGroup("fwIpDestinationGroupResource", FwIpDestinationGroupArgs.builder()
    .addresses("string")
    .countries("string")
    .description("string")
    .ipCategories("string")
    .name("string")
    .type("string")
    .build());

    fw_ip_destination_group_resource = zia.FwIpDestinationGroup("fwIpDestinationGroupResource",
    addresses=["string"],
    countries=["string"],
    description="string",
    ip_categories=["string"],
    name="string",
    type="string")

    const fwIpDestinationGroupResource = new zia.FwIpDestinationGroup("fwIpDestinationGroupResource", {
    addresses: ["string"],
    countries: ["string"],
    description: "string",
    ipCategories: ["string"],
    name: "string",
    type: "string",
});

    type: zia:FwIpDestinationGroup
properties:
    addresses:
        - string
    countries:
        - string
    description: string
    ipCategories:
        - string
    name: string
    type: string

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

    Addresses List<string>
    List of destination IP addresses, FQDNs, or wildcard FQDNs in this group.
    Countries List<string>
    List of destination countries (ISO 3166-1 alpha-2 codes). The COUNTRY_ prefix is added automatically.
    Description string
    Additional information about the IP destination group.
    IpCategories List<string>
    List of URL/IP categories allowed for this group.
    Name string
    The name of the IP destination group.
    Type string
    Destination group type. Valid values: DSTN_IP, DSTN_FQDN, DSTN_DOMAIN, DSTN_OTHER.
    Addresses []string
    List of destination IP addresses, FQDNs, or wildcard FQDNs in this group.
    Countries []string
    List of destination countries (ISO 3166-1 alpha-2 codes). The COUNTRY_ prefix is added automatically.
    Description string
    Additional information about the IP destination group.
    IpCategories []string
    List of URL/IP categories allowed for this group.
    Name string
    The name of the IP destination group.
    Type string
    Destination group type. Valid values: DSTN_IP, DSTN_FQDN, DSTN_DOMAIN, DSTN_OTHER.
    addresses List<String>
    List of destination IP addresses, FQDNs, or wildcard FQDNs in this group.
    countries List<String>
    List of destination countries (ISO 3166-1 alpha-2 codes). The COUNTRY_ prefix is added automatically.
    description String
    Additional information about the IP destination group.
    ipCategories List<String>
    List of URL/IP categories allowed for this group.
    name String
    The name of the IP destination group.
    type String
    Destination group type. Valid values: DSTN_IP, DSTN_FQDN, DSTN_DOMAIN, DSTN_OTHER.
    addresses string[]
    List of destination IP addresses, FQDNs, or wildcard FQDNs in this group.
    countries string[]
    List of destination countries (ISO 3166-1 alpha-2 codes). The COUNTRY_ prefix is added automatically.
    description string
    Additional information about the IP destination group.
    ipCategories string[]
    List of URL/IP categories allowed for this group.
    name string
    The name of the IP destination group.
    type string
    Destination group type. Valid values: DSTN_IP, DSTN_FQDN, DSTN_DOMAIN, DSTN_OTHER.
    addresses Sequence[str]
    List of destination IP addresses, FQDNs, or wildcard FQDNs in this group.
    countries Sequence[str]
    List of destination countries (ISO 3166-1 alpha-2 codes). The COUNTRY_ prefix is added automatically.
    description str
    Additional information about the IP destination group.
    ip_categories Sequence[str]
    List of URL/IP categories allowed for this group.
    name str
    The name of the IP destination group.
    type str
    Destination group type. Valid values: DSTN_IP, DSTN_FQDN, DSTN_DOMAIN, DSTN_OTHER.
    addresses List<String>
    List of destination IP addresses, FQDNs, or wildcard FQDNs in this group.
    countries List<String>
    List of destination countries (ISO 3166-1 alpha-2 codes). The COUNTRY_ prefix is added automatically.
    description String
    Additional information about the IP destination group.
    ipCategories List<String>
    List of URL/IP categories allowed for this group.
    name String
    The name of the IP destination group.
    type String
    Destination group type. Valid values: DSTN_IP, DSTN_FQDN, DSTN_DOMAIN, DSTN_OTHER.

    Outputs

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

    GroupId int
    The system-generated ID of the IP destination group.
    Id string
    The provider-assigned unique ID for this managed resource.
    GroupId int
    The system-generated ID of the IP destination group.
    Id string
    The provider-assigned unique ID for this managed resource.
    groupId Integer
    The system-generated ID of the IP destination group.
    id String
    The provider-assigned unique ID for this managed resource.
    groupId number
    The system-generated ID of the IP destination group.
    id string
    The provider-assigned unique ID for this managed resource.
    group_id int
    The system-generated ID of the IP destination group.
    id str
    The provider-assigned unique ID for this managed resource.
    groupId Number
    The system-generated ID of the IP destination group.
    id String
    The provider-assigned unique ID for this managed resource.

    Import

    An existing IP destination group can be imported using its resource ID, e.g.

    $ pulumi import zia:index:FwIpDestinationGroup 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
    Schema (JSON)
    zscaler/pulumi-zia
      Try Pulumi Cloud free. Your team will thank you.