Zscaler Internet Access v1.0.1 published on Friday, Jun 6, 2025 by Zscaler
zia.getDevices
Explore with Pulumi AI
Use the zia_devices data source to get information about a device 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
# ZIA Admin User Data Source
data "zia_devices" "device"{
name = "administrator"
}
Using getDevices
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 getDevices(args: GetDevicesArgs, opts?: InvokeOptions): Promise<GetDevicesResult>
function getDevicesOutput(args: GetDevicesOutputArgs, opts?: InvokeOptions): Output<GetDevicesResult>
def get_devices(device_group_type: Optional[str] = None,
device_model: Optional[str] = None,
hostname: Optional[str] = None,
id: Optional[int] = None,
name: Optional[str] = None,
os_type: Optional[str] = None,
os_version: Optional[str] = None,
owner_name: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetDevicesResult
def get_devices_output(device_group_type: Optional[pulumi.Input[str]] = None,
device_model: Optional[pulumi.Input[str]] = None,
hostname: Optional[pulumi.Input[str]] = None,
id: Optional[pulumi.Input[int]] = None,
name: Optional[pulumi.Input[str]] = None,
os_type: Optional[pulumi.Input[str]] = None,
os_version: Optional[pulumi.Input[str]] = None,
owner_name: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetDevicesResult]
func GetDevices(ctx *Context, args *GetDevicesArgs, opts ...InvokeOption) (*GetDevicesResult, error)
func GetDevicesOutput(ctx *Context, args *GetDevicesOutputArgs, opts ...InvokeOption) GetDevicesResultOutput
> Note: This function is named GetDevices
in the Go SDK.
public static class GetDevices
{
public static Task<GetDevicesResult> InvokeAsync(GetDevicesArgs args, InvokeOptions? opts = null)
public static Output<GetDevicesResult> Invoke(GetDevicesInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetDevicesResult> getDevices(GetDevicesArgs args, InvokeOptions options)
public static Output<GetDevicesResult> getDevices(GetDevicesArgs args, InvokeOptions options)
fn::invoke:
function: zia:index/getDevices:getDevices
arguments:
# arguments dictionary
The following arguments are supported:
- Device
Group stringType - (String) The device group type. i.e
ZCC_OS
,NON_ZCC
,CBI
- Device
Model string - (String) The device model.
- Hostname string
- Id int
- The unique identifer for the devices.
- Name string
- The name of the devices to be exported.
- Os
Type string - (String) The operating system (OS).
ANY
,OTHER_OS
,IOS
,ANDROID_OS
,WINDOWS_OS
,MAC_OS
,LINUX
- Os
Version string - (String) The operating system version.
- Owner
Name string - (String) The device owner's user name.
- Device
Group stringType - (String) The device group type. i.e
ZCC_OS
,NON_ZCC
,CBI
- Device
Model string - (String) The device model.
- Hostname string
- Id int
- The unique identifer for the devices.
- Name string
- The name of the devices to be exported.
- Os
Type string - (String) The operating system (OS).
ANY
,OTHER_OS
,IOS
,ANDROID_OS
,WINDOWS_OS
,MAC_OS
,LINUX
- Os
Version string - (String) The operating system version.
- Owner
Name string - (String) The device owner's user name.
- device
Group StringType - (String) The device group type. i.e
ZCC_OS
,NON_ZCC
,CBI
- device
Model String - (String) The device model.
- hostname String
- id Integer
- The unique identifer for the devices.
- name String
- The name of the devices to be exported.
- os
Type String - (String) The operating system (OS).
ANY
,OTHER_OS
,IOS
,ANDROID_OS
,WINDOWS_OS
,MAC_OS
,LINUX
- os
Version String - (String) The operating system version.
- owner
Name String - (String) The device owner's user name.
- device
Group stringType - (String) The device group type. i.e
ZCC_OS
,NON_ZCC
,CBI
- device
Model string - (String) The device model.
- hostname string
- id number
- The unique identifer for the devices.
- name string
- The name of the devices to be exported.
- os
Type string - (String) The operating system (OS).
ANY
,OTHER_OS
,IOS
,ANDROID_OS
,WINDOWS_OS
,MAC_OS
,LINUX
- os
Version string - (String) The operating system version.
- owner
Name string - (String) The device owner's user name.
- device_
group_ strtype - (String) The device group type. i.e
ZCC_OS
,NON_ZCC
,CBI
- device_
model str - (String) The device model.
- hostname str
- id int
- The unique identifer for the devices.
- name str
- The name of the devices to be exported.
- os_
type str - (String) The operating system (OS).
ANY
,OTHER_OS
,IOS
,ANDROID_OS
,WINDOWS_OS
,MAC_OS
,LINUX
- os_
version str - (String) The operating system version.
- owner_
name str - (String) The device owner's user name.
- device
Group StringType - (String) The device group type. i.e
ZCC_OS
,NON_ZCC
,CBI
- device
Model String - (String) The device model.
- hostname String
- id Number
- The unique identifer for the devices.
- name String
- The name of the devices to be exported.
- os
Type String - (String) The operating system (OS).
ANY
,OTHER_OS
,IOS
,ANDROID_OS
,WINDOWS_OS
,MAC_OS
,LINUX
- os
Version String - (String) The operating system version.
- owner
Name String - (String) The device owner's user name.
getDevices Result
The following output properties are available:
- Description string
- (String) The device's description.
- Device
Group stringType - (String) The device group type. i.e
ZCC_OS
,NON_ZCC
,CBI
- Device
Model string - (String) The device model.
- Hostname string
- Id int
- (String) The unique identifer for the device group.
- Name string
- (String) The device name.
- Os
Type string - (String) The operating system (OS).
ANY
,OTHER_OS
,IOS
,ANDROID_OS
,WINDOWS_OS
,MAC_OS
,LINUX
- Os
Version string - (String) The operating system version.
- Owner
Name string - (String) The device owner's user name.
- Owner
User intId - (int) The unique identifier of the device owner (i.e., user).
- Description string
- (String) The device's description.
- Device
Group stringType - (String) The device group type. i.e
ZCC_OS
,NON_ZCC
,CBI
- Device
Model string - (String) The device model.
- Hostname string
- Id int
- (String) The unique identifer for the device group.
- Name string
- (String) The device name.
- Os
Type string - (String) The operating system (OS).
ANY
,OTHER_OS
,IOS
,ANDROID_OS
,WINDOWS_OS
,MAC_OS
,LINUX
- Os
Version string - (String) The operating system version.
- Owner
Name string - (String) The device owner's user name.
- Owner
User intId - (int) The unique identifier of the device owner (i.e., user).
- description String
- (String) The device's description.
- device
Group StringType - (String) The device group type. i.e
ZCC_OS
,NON_ZCC
,CBI
- device
Model String - (String) The device model.
- hostname String
- id Integer
- (String) The unique identifer for the device group.
- name String
- (String) The device name.
- os
Type String - (String) The operating system (OS).
ANY
,OTHER_OS
,IOS
,ANDROID_OS
,WINDOWS_OS
,MAC_OS
,LINUX
- os
Version String - (String) The operating system version.
- owner
Name String - (String) The device owner's user name.
- owner
User IntegerId - (int) The unique identifier of the device owner (i.e., user).
- description string
- (String) The device's description.
- device
Group stringType - (String) The device group type. i.e
ZCC_OS
,NON_ZCC
,CBI
- device
Model string - (String) The device model.
- hostname string
- id number
- (String) The unique identifer for the device group.
- name string
- (String) The device name.
- os
Type string - (String) The operating system (OS).
ANY
,OTHER_OS
,IOS
,ANDROID_OS
,WINDOWS_OS
,MAC_OS
,LINUX
- os
Version string - (String) The operating system version.
- owner
Name string - (String) The device owner's user name.
- owner
User numberId - (int) The unique identifier of the device owner (i.e., user).
- description str
- (String) The device's description.
- device_
group_ strtype - (String) The device group type. i.e
ZCC_OS
,NON_ZCC
,CBI
- device_
model str - (String) The device model.
- hostname str
- id int
- (String) The unique identifer for the device group.
- name str
- (String) The device name.
- os_
type str - (String) The operating system (OS).
ANY
,OTHER_OS
,IOS
,ANDROID_OS
,WINDOWS_OS
,MAC_OS
,LINUX
- os_
version str - (String) The operating system version.
- owner_
name str - (String) The device owner's user name.
- owner_
user_ intid - (int) The unique identifier of the device owner (i.e., user).
- description String
- (String) The device's description.
- device
Group StringType - (String) The device group type. i.e
ZCC_OS
,NON_ZCC
,CBI
- device
Model String - (String) The device model.
- hostname String
- id Number
- (String) The unique identifer for the device group.
- name String
- (String) The device name.
- os
Type String - (String) The operating system (OS).
ANY
,OTHER_OS
,IOS
,ANDROID_OS
,WINDOWS_OS
,MAC_OS
,LINUX
- os
Version String - (String) The operating system version.
- owner
Name String - (String) The device owner's user name.
- owner
User NumberId - (int) The unique identifier of the device owner (i.e., user).
Package Details
- Repository
- zia zscaler/pulumi-zia
- License
- MIT
- Notes
- This Pulumi package is based on the
zia
Terraform Provider.