1. Packages
  2. Zscaler Internet Access (ZIA)
  3. API Docs
  4. getDatacenters
Zscaler Internet Access v1.2.0 published on Friday, Feb 20, 2026 by Zscaler
Schema (JSON)
zscaler/pulumi-zia

zia.getDatacenters

zia logo
Zscaler Internet Access v1.2.0 published on Friday, Feb 20, 2026 by Zscaler
Schema (JSON)
zscaler/pulumi-zia

    Use the zia_datacenters data source to retrieve the list of Zscaler data centers (DCs) that can be excluded from service to your organization.

    NOTE: This an Early Access feature.

    Example Usage

    Retrieve All Datacenters

    data "zia_datacenters" "all" {
}

    Filter By Name

    data "zia_datacenters" "filtered" {
    name = "CA Client Node DC"
}

    Filter By Multiple Criteria

    data "zia_datacenters" "filtered" {
    city            = "San Jose"
    dc_provider     = "Zscaler Internal"
    gov_only        = false
    third_party_cloud = false
    virtual         = false
}

    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:index/getDatacenters:getDatacenters
  arguments:
    # arguments dictionary

    The following arguments are supported:

    City string
    (String) City where the datacenter is located.
    DatacenterId int
    (Integer, Computed) When filtering by ID or when exactly one datacenter matches, the datacenter's numeric ID. Prefer this over datacenters[0].id when you expect a single result (e.g. name = "SJC4").
    Name string
    (String) Zscaler data center name.
    City string
    (String) City where the datacenter is located.
    DatacenterId int
    (Integer, Computed) When filtering by ID or when exactly one datacenter matches, the datacenter's numeric ID. Prefer this over datacenters[0].id when you expect a single result (e.g. name = "SJC4").
    Name string
    (String) Zscaler data center name.
    city String
    (String) City where the datacenter is located.
    datacenterId Integer
    (Integer, Computed) When filtering by ID or when exactly one datacenter matches, the datacenter's numeric ID. Prefer this over datacenters[0].id when you expect a single result (e.g. name = "SJC4").
    name String
    (String) Zscaler data center name.
    city string
    (String) City where the datacenter is located.
    datacenterId number
    (Integer, Computed) When filtering by ID or when exactly one datacenter matches, the datacenter's numeric ID. Prefer this over datacenters[0].id when you expect a single result (e.g. name = "SJC4").
    name string
    (String) Zscaler data center name.
    city str
    (String) City where the datacenter is located.
    datacenter_id int
    (Integer, Computed) When filtering by ID or when exactly one datacenter matches, the datacenter's numeric ID. Prefer this over datacenters[0].id when you expect a single result (e.g. name = "SJC4").
    name str
    (String) Zscaler data center name.
    city String
    (String) City where the datacenter is located.
    datacenterId Number
    (Integer, Computed) When filtering by ID or when exactly one datacenter matches, the datacenter's numeric ID. Prefer this over datacenters[0].id when you expect a single result (e.g. name = "SJC4").
    name String
    (String) Zscaler data center name.

    getDatacenters Result

    The following output properties are available:

    City string
    (String) City where the datacenter is located.
    DatacenterId int
    (Integer, Computed) When filtering by ID or when exactly one datacenter matches, the datacenter's numeric ID. Prefer this over datacenters[0].id when you expect a single result (e.g. name = "SJC4").
    Datacenters List<zscaler.PulumiPackage.Zia.Outputs.GetDatacentersDatacenter>
    (List) List of datacenters matching the filter criteria.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    (String) Zscaler data center name.
    City string
    (String) City where the datacenter is located.
    DatacenterId int
    (Integer, Computed) When filtering by ID or when exactly one datacenter matches, the datacenter's numeric ID. Prefer this over datacenters[0].id when you expect a single result (e.g. name = "SJC4").
    Datacenters []GetDatacentersDatacenter
    (List) List of datacenters matching the filter criteria.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    (String) Zscaler data center name.
    city String
    (String) City where the datacenter is located.
    datacenterId Integer
    (Integer, Computed) When filtering by ID or when exactly one datacenter matches, the datacenter's numeric ID. Prefer this over datacenters[0].id when you expect a single result (e.g. name = "SJC4").
    datacenters List<GetDatacentersDatacenter>
    (List) List of datacenters matching the filter criteria.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    (String) Zscaler data center name.
    city string
    (String) City where the datacenter is located.
    datacenterId number
    (Integer, Computed) When filtering by ID or when exactly one datacenter matches, the datacenter's numeric ID. Prefer this over datacenters[0].id when you expect a single result (e.g. name = "SJC4").
    datacenters GetDatacentersDatacenter[]
    (List) List of datacenters matching the filter criteria.
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    (String) Zscaler data center name.
    city str
    (String) City where the datacenter is located.
    datacenter_id int
    (Integer, Computed) When filtering by ID or when exactly one datacenter matches, the datacenter's numeric ID. Prefer this over datacenters[0].id when you expect a single result (e.g. name = "SJC4").
    datacenters Sequence[GetDatacentersDatacenter]
    (List) List of datacenters matching the filter criteria.
    id str
    The provider-assigned unique ID for this managed resource.
    name str
    (String) Zscaler data center name.
    city String
    (String) City where the datacenter is located.
    datacenterId Number
    (Integer, Computed) When filtering by ID or when exactly one datacenter matches, the datacenter's numeric ID. Prefer this over datacenters[0].id when you expect a single result (e.g. name = "SJC4").
    datacenters List<Property Map>
    (List) List of datacenters matching the filter criteria.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    (String) Zscaler data center name.

    Supporting Types

    GetDatacentersDatacenter

    City string
    (String) City where the datacenter is located.
    CreateTime int
    (Integer) Timestamp when the datacenter was created.
    DontProvision bool
    (Boolean) Whether the datacenter should not be provisioned.
    DontPublish bool
    (Boolean) Whether the datacenter should not be published.
    DownloadBandwidth int
    (Integer) Download bandwidth in bytes per second.
    ForFutureUse bool
    (Boolean) Whether the datacenter is reserved for future use.
    GovOnly bool
    (Boolean) Whether this is a government-only datacenter.
    Id int
    (Integer) Unique identifier for the datacenter.
    LastModifiedTime int
    (Integer) Timestamp when the datacenter was last modified.
    Lat int
    (Integer) Latitude coordinate (legacy field).
    Latitude double
    (Float) Latitude coordinate.
    Longi int
    (Integer) Longitude coordinate (legacy field).
    Longitude double
    (Float) Longitude coordinate.
    ManagedBcp bool
    (Boolean) Whether the datacenter is managed by BCP.
    Name string
    (String) Zscaler data center name.
    NotReadyForUse bool
    (Boolean) Whether the datacenter is not ready for use.
    OwnedByCustomer bool
    (Boolean) Whether the datacenter is owned by the customer.
    Provider string
    (String) Provider of the datacenter.
    RegionalSurcharge bool
    (Boolean) Whether there is a regional surcharge for this datacenter.
    ThirdPartyCloud bool
    (Boolean) Whether this is a third-party cloud datacenter.
    Timezone string
    (String) Timezone of the datacenter.
    UploadBandwidth int
    (Integer) Upload bandwidth in bytes per second.
    Virtual bool
    (Boolean) Whether this is a virtual datacenter.
    City string
    (String) City where the datacenter is located.
    CreateTime int
    (Integer) Timestamp when the datacenter was created.
    DontProvision bool
    (Boolean) Whether the datacenter should not be provisioned.
    DontPublish bool
    (Boolean) Whether the datacenter should not be published.
    DownloadBandwidth int
    (Integer) Download bandwidth in bytes per second.
    ForFutureUse bool
    (Boolean) Whether the datacenter is reserved for future use.
    GovOnly bool
    (Boolean) Whether this is a government-only datacenter.
    Id int
    (Integer) Unique identifier for the datacenter.
    LastModifiedTime int
    (Integer) Timestamp when the datacenter was last modified.
    Lat int
    (Integer) Latitude coordinate (legacy field).
    Latitude float64
    (Float) Latitude coordinate.
    Longi int
    (Integer) Longitude coordinate (legacy field).
    Longitude float64
    (Float) Longitude coordinate.
    ManagedBcp bool
    (Boolean) Whether the datacenter is managed by BCP.
    Name string
    (String) Zscaler data center name.
    NotReadyForUse bool
    (Boolean) Whether the datacenter is not ready for use.
    OwnedByCustomer bool
    (Boolean) Whether the datacenter is owned by the customer.
    Provider string
    (String) Provider of the datacenter.
    RegionalSurcharge bool
    (Boolean) Whether there is a regional surcharge for this datacenter.
    ThirdPartyCloud bool
    (Boolean) Whether this is a third-party cloud datacenter.
    Timezone string
    (String) Timezone of the datacenter.
    UploadBandwidth int
    (Integer) Upload bandwidth in bytes per second.
    Virtual bool
    (Boolean) Whether this is a virtual datacenter.
    city String
    (String) City where the datacenter is located.
    createTime Integer
    (Integer) Timestamp when the datacenter was created.
    dontProvision Boolean
    (Boolean) Whether the datacenter should not be provisioned.
    dontPublish Boolean
    (Boolean) Whether the datacenter should not be published.
    downloadBandwidth Integer
    (Integer) Download bandwidth in bytes per second.
    forFutureUse Boolean
    (Boolean) Whether the datacenter is reserved for future use.
    govOnly Boolean
    (Boolean) Whether this is a government-only datacenter.
    id Integer
    (Integer) Unique identifier for the datacenter.
    lastModifiedTime Integer
    (Integer) Timestamp when the datacenter was last modified.
    lat Integer
    (Integer) Latitude coordinate (legacy field).
    latitude Double
    (Float) Latitude coordinate.
    longi Integer
    (Integer) Longitude coordinate (legacy field).
    longitude Double
    (Float) Longitude coordinate.
    managedBcp Boolean
    (Boolean) Whether the datacenter is managed by BCP.
    name String
    (String) Zscaler data center name.
    notReadyForUse Boolean
    (Boolean) Whether the datacenter is not ready for use.
    ownedByCustomer Boolean
    (Boolean) Whether the datacenter is owned by the customer.
    provider String
    (String) Provider of the datacenter.
    regionalSurcharge Boolean
    (Boolean) Whether there is a regional surcharge for this datacenter.
    thirdPartyCloud Boolean
    (Boolean) Whether this is a third-party cloud datacenter.
    timezone String
    (String) Timezone of the datacenter.
    uploadBandwidth Integer
    (Integer) Upload bandwidth in bytes per second.
    virtual Boolean
    (Boolean) Whether this is a virtual datacenter.
    city string
    (String) City where the datacenter is located.
    createTime number
    (Integer) Timestamp when the datacenter was created.
    dontProvision boolean
    (Boolean) Whether the datacenter should not be provisioned.
    dontPublish boolean
    (Boolean) Whether the datacenter should not be published.
    downloadBandwidth number
    (Integer) Download bandwidth in bytes per second.
    forFutureUse boolean
    (Boolean) Whether the datacenter is reserved for future use.
    govOnly boolean
    (Boolean) Whether this is a government-only datacenter.
    id number
    (Integer) Unique identifier for the datacenter.
    lastModifiedTime number
    (Integer) Timestamp when the datacenter was last modified.
    lat number
    (Integer) Latitude coordinate (legacy field).
    latitude number
    (Float) Latitude coordinate.
    longi number
    (Integer) Longitude coordinate (legacy field).
    longitude number
    (Float) Longitude coordinate.
    managedBcp boolean
    (Boolean) Whether the datacenter is managed by BCP.
    name string
    (String) Zscaler data center name.
    notReadyForUse boolean
    (Boolean) Whether the datacenter is not ready for use.
    ownedByCustomer boolean
    (Boolean) Whether the datacenter is owned by the customer.
    provider string
    (String) Provider of the datacenter.
    regionalSurcharge boolean
    (Boolean) Whether there is a regional surcharge for this datacenter.
    thirdPartyCloud boolean
    (Boolean) Whether this is a third-party cloud datacenter.
    timezone string
    (String) Timezone of the datacenter.
    uploadBandwidth number
    (Integer) Upload bandwidth in bytes per second.
    virtual boolean
    (Boolean) Whether this is a virtual datacenter.
    city str
    (String) City where the datacenter is located.
    create_time int
    (Integer) Timestamp when the datacenter was created.
    dont_provision bool
    (Boolean) Whether the datacenter should not be provisioned.
    dont_publish bool
    (Boolean) Whether the datacenter should not be published.
    download_bandwidth int
    (Integer) Download bandwidth in bytes per second.
    for_future_use bool
    (Boolean) Whether the datacenter is reserved for future use.
    gov_only bool
    (Boolean) Whether this is a government-only datacenter.
    id int
    (Integer) Unique identifier for the datacenter.
    last_modified_time int
    (Integer) Timestamp when the datacenter was last modified.
    lat int
    (Integer) Latitude coordinate (legacy field).
    latitude float
    (Float) Latitude coordinate.
    longi int
    (Integer) Longitude coordinate (legacy field).
    longitude float
    (Float) Longitude coordinate.
    managed_bcp bool
    (Boolean) Whether the datacenter is managed by BCP.
    name str
    (String) Zscaler data center name.
    not_ready_for_use bool
    (Boolean) Whether the datacenter is not ready for use.
    owned_by_customer bool
    (Boolean) Whether the datacenter is owned by the customer.
    provider str
    (String) Provider of the datacenter.
    regional_surcharge bool
    (Boolean) Whether there is a regional surcharge for this datacenter.
    third_party_cloud bool
    (Boolean) Whether this is a third-party cloud datacenter.
    timezone str
    (String) Timezone of the datacenter.
    upload_bandwidth int
    (Integer) Upload bandwidth in bytes per second.
    virtual bool
    (Boolean) Whether this is a virtual datacenter.
    city String
    (String) City where the datacenter is located.
    createTime Number
    (Integer) Timestamp when the datacenter was created.
    dontProvision Boolean
    (Boolean) Whether the datacenter should not be provisioned.
    dontPublish Boolean
    (Boolean) Whether the datacenter should not be published.
    downloadBandwidth Number
    (Integer) Download bandwidth in bytes per second.
    forFutureUse Boolean
    (Boolean) Whether the datacenter is reserved for future use.
    govOnly Boolean
    (Boolean) Whether this is a government-only datacenter.
    id Number
    (Integer) Unique identifier for the datacenter.
    lastModifiedTime Number
    (Integer) Timestamp when the datacenter was last modified.
    lat Number
    (Integer) Latitude coordinate (legacy field).
    latitude Number
    (Float) Latitude coordinate.
    longi Number
    (Integer) Longitude coordinate (legacy field).
    longitude Number
    (Float) Longitude coordinate.
    managedBcp Boolean
    (Boolean) Whether the datacenter is managed by BCP.
    name String
    (String) Zscaler data center name.
    notReadyForUse Boolean
    (Boolean) Whether the datacenter is not ready for use.
    ownedByCustomer Boolean
    (Boolean) Whether the datacenter is owned by the customer.
    provider String
    (String) Provider of the datacenter.
    regionalSurcharge Boolean
    (Boolean) Whether there is a regional surcharge for this datacenter.
    thirdPartyCloud Boolean
    (Boolean) Whether this is a third-party cloud datacenter.
    timezone String
    (String) Timezone of the datacenter.
    uploadBandwidth Number
    (Integer) Upload bandwidth in bytes per second.
    virtual Boolean
    (Boolean) Whether this is a virtual datacenter.

    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
    Schema (JSON)
    zscaler/pulumi-zia
      Meet Neo: Your AI Platform Teammate