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

    Use the zia:index/getDatacenters:getDatacenters data source to retrieve a list of Zscaler data centers. Results can be filtered by datacenter ID, name (case-insensitive partial match), or city (case-insensitive partial match).

    Example Usage

    Retrieve All Datacenters

    Example coming soon!

    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/zscaler/pulumi-zia/sdk/go/pulumi-zia"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		all, err := zia.GetDatacenters(ctx, &zia.GetDatacentersArgs{}, nil)
    		if err != nil {
    			return err
    		}
    		ctx.Export("datacenters", pulumi.ToStringArray(all.Datacenters))
    		return nil
    	})
    }
    

    Example coming soon!

    import * as pulumi from "@pulumi/pulumi";
    import * as zia from "@bdzscaler/pulumi-zia";
    
    const all = zia.getDatacenters({});
    export const datacenters = all.then(r => r.datacenters);
    
    import pulumi
    import zscaler_pulumi_zia as zia
    
    all = zia.get_datacenters()
    pulumi.export("datacenters", all.datacenters)
    
    variables:
      all:
        fn::invoke:
          function: zia:getDatacenters
          arguments: {}
    outputs:
      datacenters: ${all.datacenters}
    

    Filter by City

    Example coming soon!

    Example coming soon!

    Example coming soon!

    import * as pulumi from "@pulumi/pulumi";
    import * as zia from "@bdzscaler/pulumi-zia";
    
    const dc = zia.getDatacenters({ city: "San Jose" });
    export const datacenters = dc.then(r => r.datacenters);
    
    import pulumi
    import zscaler_pulumi_zia as zia
    
    dc = zia.get_datacenters(city="San Jose")
    pulumi.export("datacenters", dc.datacenters)
    

    Example coming soon!

    Using getDatacenters

    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 getDatacenters(args: GetDatacentersArgs, opts?: InvokeOptions): Promise<GetDatacentersResult>
    function getDatacentersOutput(args: GetDatacentersOutputArgs, opts?: InvokeOptions): Output<GetDatacentersResult>
    def get_datacenters(city: Optional[str] = None,
                        datacenter_id: Optional[int] = None,
                        name: Optional[str] = None,
                        opts: Optional[InvokeOptions] = None) -> GetDatacentersResult
    def get_datacenters_output(city: Optional[pulumi.Input[str]] = None,
                        datacenter_id: Optional[pulumi.Input[int]] = None,
                        name: Optional[pulumi.Input[str]] = None,
                        opts: Optional[InvokeOptions] = None) -> Output[GetDatacentersResult]
    func GetDatacenters(ctx *Context, args *GetDatacentersArgs, opts ...InvokeOption) (*GetDatacentersResult, error)
    func GetDatacentersOutput(ctx *Context, args *GetDatacentersOutputArgs, opts ...InvokeOption) GetDatacentersResultOutput

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

    public static class GetDatacenters 
    {
        public static Task<GetDatacentersResult> InvokeAsync(GetDatacentersArgs args, InvokeOptions? opts = null)
        public static Output<GetDatacentersResult> Invoke(GetDatacentersInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetDatacentersResult> getDatacenters(GetDatacentersArgs args, InvokeOptions options)
    public static Output<GetDatacentersResult> getDatacenters(GetDatacentersArgs args, InvokeOptions options)
    
    fn::invoke:
      function: zia:getDatacenters
      arguments:
        # arguments dictionary

    The following arguments are supported:

    City string
    Filter datacenters by city (case-insensitive partial match). When exactly one result is returned, this is set to that datacenter's city.
    DatacenterId int
    Filter datacenters by ID. When exactly one result is returned, this is set to that datacenter's ID.
    Name string
    Filter datacenters by name (case-insensitive partial match). When exactly one result is returned, this is set to that datacenter's name.
    City string
    Filter datacenters by city (case-insensitive partial match). When exactly one result is returned, this is set to that datacenter's city.
    DatacenterId int
    Filter datacenters by ID. When exactly one result is returned, this is set to that datacenter's ID.
    Name string
    Filter datacenters by name (case-insensitive partial match). When exactly one result is returned, this is set to that datacenter's name.
    city String
    Filter datacenters by city (case-insensitive partial match). When exactly one result is returned, this is set to that datacenter's city.
    datacenterId Integer
    Filter datacenters by ID. When exactly one result is returned, this is set to that datacenter's ID.
    name String
    Filter datacenters by name (case-insensitive partial match). When exactly one result is returned, this is set to that datacenter's name.
    city string
    Filter datacenters by city (case-insensitive partial match). When exactly one result is returned, this is set to that datacenter's city.
    datacenterId number
    Filter datacenters by ID. When exactly one result is returned, this is set to that datacenter's ID.
    name string
    Filter datacenters by name (case-insensitive partial match). When exactly one result is returned, this is set to that datacenter's name.
    city str
    Filter datacenters by city (case-insensitive partial match). When exactly one result is returned, this is set to that datacenter's city.
    datacenter_id int
    Filter datacenters by ID. When exactly one result is returned, this is set to that datacenter's ID.
    name str
    Filter datacenters by name (case-insensitive partial match). When exactly one result is returned, this is set to that datacenter's name.
    city String
    Filter datacenters by city (case-insensitive partial match). When exactly one result is returned, this is set to that datacenter's city.
    datacenterId Number
    Filter datacenters by ID. When exactly one result is returned, this is set to that datacenter's ID.
    name String
    Filter datacenters by name (case-insensitive partial match). When exactly one result is returned, this is set to that datacenter's name.

    getDatacenters Result

    The following output properties are available:

    Datacenters List<zscaler.PulumiPackage.Zia.Outputs.DatacenterInfo>
    List of datacenters matching the filter criteria.
    City string
    The datacenter city when exactly one result is returned.
    DatacenterId int
    The datacenter ID when exactly one result is returned.
    Name string
    The datacenter name when exactly one result is returned.
    Datacenters []DatacenterInfo
    List of datacenters matching the filter criteria.
    City string
    The datacenter city when exactly one result is returned.
    DatacenterId int
    The datacenter ID when exactly one result is returned.
    Name string
    The datacenter name when exactly one result is returned.
    datacenters List<DatacenterInfo>
    List of datacenters matching the filter criteria.
    city String
    The datacenter city when exactly one result is returned.
    datacenterId Integer
    The datacenter ID when exactly one result is returned.
    name String
    The datacenter name when exactly one result is returned.
    datacenters DatacenterInfo[]
    List of datacenters matching the filter criteria.
    city string
    The datacenter city when exactly one result is returned.
    datacenterId number
    The datacenter ID when exactly one result is returned.
    name string
    The datacenter name when exactly one result is returned.
    datacenters Sequence[DatacenterInfo]
    List of datacenters matching the filter criteria.
    city str
    The datacenter city when exactly one result is returned.
    datacenter_id int
    The datacenter ID when exactly one result is returned.
    name str
    The datacenter name when exactly one result is returned.
    datacenters List<Property Map>
    List of datacenters matching the filter criteria.
    city String
    The datacenter city when exactly one result is returned.
    datacenterId Number
    The datacenter ID when exactly one result is returned.
    name String
    The datacenter name when exactly one result is returned.

    Supporting Types

    DatacenterInfo

    city String
    createTime Integer
    dontProvision Boolean
    dontPublish Boolean
    downloadBandwidth Integer
    forFutureUse Boolean
    govOnly Boolean
    id Integer
    lastModifiedTime Integer
    lat Integer
    latitude Double
    longi Integer
    longitude Double
    managedBcp Boolean
    name String
    notReadyForUse Boolean
    ownedByCustomer Boolean
    provider String
    regionalSurcharge Boolean
    thirdPartyCloud Boolean
    timezone String
    uploadBandwidth Integer
    virtual Boolean
    city string
    createTime number
    dontProvision boolean
    dontPublish boolean
    downloadBandwidth number
    forFutureUse boolean
    govOnly boolean
    id number
    lastModifiedTime number
    lat number
    latitude number
    longi number
    longitude number
    managedBcp boolean
    name string
    notReadyForUse boolean
    ownedByCustomer boolean
    provider string
    regionalSurcharge boolean
    thirdPartyCloud boolean
    timezone string
    uploadBandwidth number
    virtual boolean
    city String
    createTime Number
    dontProvision Boolean
    dontPublish Boolean
    downloadBandwidth Number
    forFutureUse Boolean
    govOnly Boolean
    id Number
    lastModifiedTime Number
    lat Number
    latitude Number
    longi Number
    longitude Number
    managedBcp Boolean
    name String
    notReadyForUse Boolean
    ownedByCustomer Boolean
    provider String
    regionalSurcharge Boolean
    thirdPartyCloud Boolean
    timezone String
    uploadBandwidth Number
    virtual Boolean

    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
      Try Pulumi Cloud free. Your team will thank you.