Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. Zscaler Internet Access (ZIA)
  3. API Docs
  4. getDeviceGroups
Zscaler Internet Access v0.0.7 published on Tuesday, Jul 30, 2024 by Zscaler
zscaler/pulumi-zia

zia.getDeviceGroups

Explore with Pulumi AI

zia logo
Zscaler Internet Access v0.0.7 published on Tuesday, Jul 30, 2024 by Zscaler
zscaler/pulumi-zia

    Use the zia_device_groups data source to get information about a device group in the Zscaler Internet Access cloud or via the API. This data source can then be associated with resources such as: URL Filtering Rules

    Example Usage

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

const ios = zia.getDeviceGroups({
    name: "IOS",
});

    import pulumi
import pulumi_zia as zia

ios = zia.get_device_groups(name="IOS")

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/zscaler/pulumi-zia/sdk/go/zia"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := zia.GetDeviceGroups(ctx, &zia.GetDeviceGroupsArgs{
			Name: pulumi.StringRef("IOS"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Zia = Pulumi.Zia;

return await Deployment.RunAsync(() => 
{
    var ios = Zia.GetDeviceGroups.Invoke(new()
    {
        Name = "IOS",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.zia.ZiaFunctions;
import com.pulumi.zia.inputs.GetDeviceGroupsArgs;
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) {
        final var ios = ZiaFunctions.getDeviceGroups(GetDeviceGroupsArgs.builder()
            .name("IOS")
            .build());

    }
}

    variables:
  ios:
    fn::invoke:
      Function: zia:getDeviceGroups
      Arguments:
        name: IOS

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

const android = zia.getDeviceGroups({
    name: "Android",
});

    import pulumi
import pulumi_zia as zia

android = zia.get_device_groups(name="Android")

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/zscaler/pulumi-zia/sdk/go/zia"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := zia.GetDeviceGroups(ctx, &zia.GetDeviceGroupsArgs{
			Name: pulumi.StringRef("Android"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Zia = Pulumi.Zia;

return await Deployment.RunAsync(() => 
{
    var android = Zia.GetDeviceGroups.Invoke(new()
    {
        Name = "Android",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.zia.ZiaFunctions;
import com.pulumi.zia.inputs.GetDeviceGroupsArgs;
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) {
        final var android = ZiaFunctions.getDeviceGroups(GetDeviceGroupsArgs.builder()
            .name("Android")
            .build());

    }
}

    variables:
  android:
    fn::invoke:
      Function: zia:getDeviceGroups
      Arguments:
        name: Android

    Using getDeviceGroups

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getDeviceGroups(args: GetDeviceGroupsArgs, opts?: InvokeOptions): Promise<GetDeviceGroupsResult>
function getDeviceGroupsOutput(args: GetDeviceGroupsOutputArgs, opts?: InvokeOptions): Output<GetDeviceGroupsResult>
    def get_device_groups(name: Optional[str] = None,
                      opts: Optional[InvokeOptions] = None) -> GetDeviceGroupsResult
def get_device_groups_output(name: Optional[pulumi.Input[str]] = None,
                      opts: Optional[InvokeOptions] = None) -> Output[GetDeviceGroupsResult]
    func GetDeviceGroups(ctx *Context, args *GetDeviceGroupsArgs, opts ...InvokeOption) (*GetDeviceGroupsResult, error)
func GetDeviceGroupsOutput(ctx *Context, args *GetDeviceGroupsOutputArgs, opts ...InvokeOption) GetDeviceGroupsResultOutput

    > Note: This function is named GetDeviceGroups in the Go SDK.

    public static class GetDeviceGroups 
{
    public static Task<GetDeviceGroupsResult> InvokeAsync(GetDeviceGroupsArgs args, InvokeOptions? opts = null)
    public static Output<GetDeviceGroupsResult> Invoke(GetDeviceGroupsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetDeviceGroupsResult> getDeviceGroups(GetDeviceGroupsArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet

    fn::invoke:
  function: zia:index/getDeviceGroups:getDeviceGroups
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Name string
    The name of the device group to be exported.
    Name string
    The name of the device group to be exported.
    name String
    The name of the device group to be exported.
    name string
    The name of the device group to be exported.
    name str
    The name of the device group to be exported.
    name String
    The name of the device group to be exported.

    getDeviceGroups Result

    The following output properties are available:

    Description string
    (String) The device group's description.
    DeviceCount int
    (int) The number of devices within the group.
    DeviceNames string
    (String) The names of devices that belong to the device group. The device names are comma-separated.
    GroupType string
    (String) The device group type. i.e ZCC_OS, NON_ZCC, CBI
    Id int
    (String) The unique identifer for the device group.
    OsType string
    (String) The operating system (OS).
    Predefined bool
    (Boolean) Indicates whether this is a predefined device group. If this value is set to true, the group is predefined.
    Name string
    (String) The device group name.
    Description string
    (String) The device group's description.
    DeviceCount int
    (int) The number of devices within the group.
    DeviceNames string
    (String) The names of devices that belong to the device group. The device names are comma-separated.
    GroupType string
    (String) The device group type. i.e ZCC_OS, NON_ZCC, CBI
    Id int
    (String) The unique identifer for the device group.
    OsType string
    (String) The operating system (OS).
    Predefined bool
    (Boolean) Indicates whether this is a predefined device group. If this value is set to true, the group is predefined.
    Name string
    (String) The device group name.
    description String
    (String) The device group's description.
    deviceCount Integer
    (int) The number of devices within the group.
    deviceNames String
    (String) The names of devices that belong to the device group. The device names are comma-separated.
    groupType String
    (String) The device group type. i.e ZCC_OS, NON_ZCC, CBI
    id Integer
    (String) The unique identifer for the device group.
    osType String
    (String) The operating system (OS).
    predefined Boolean
    (Boolean) Indicates whether this is a predefined device group. If this value is set to true, the group is predefined.
    name String
    (String) The device group name.
    description string
    (String) The device group's description.
    deviceCount number
    (int) The number of devices within the group.
    deviceNames string
    (String) The names of devices that belong to the device group. The device names are comma-separated.
    groupType string
    (String) The device group type. i.e ZCC_OS, NON_ZCC, CBI
    id number
    (String) The unique identifer for the device group.
    osType string
    (String) The operating system (OS).
    predefined boolean
    (Boolean) Indicates whether this is a predefined device group. If this value is set to true, the group is predefined.
    name string
    (String) The device group name.
    description str
    (String) The device group's description.
    device_count int
    (int) The number of devices within the group.
    device_names str
    (String) The names of devices that belong to the device group. The device names are comma-separated.
    group_type str
    (String) The device group type. i.e ZCC_OS, NON_ZCC, CBI
    id int
    (String) The unique identifer for the device group.
    os_type str
    (String) The operating system (OS).
    predefined bool
    (Boolean) Indicates whether this is a predefined device group. If this value is set to true, the group is predefined.
    name str
    (String) The device group name.
    description String
    (String) The device group's description.
    deviceCount Number
    (int) The number of devices within the group.
    deviceNames String
    (String) The names of devices that belong to the device group. The device names are comma-separated.
    groupType String
    (String) The device group type. i.e ZCC_OS, NON_ZCC, CBI
    id Number
    (String) The unique identifer for the device group.
    osType String
    (String) The operating system (OS).
    predefined Boolean
    (Boolean) Indicates whether this is a predefined device group. If this value is set to true, the group is predefined.
    name String
    (String) The device group name.

    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 v0.0.7 published on Tuesday, Jul 30, 2024 by Zscaler
    zscaler/pulumi-zia