1. Packages
  2. Zscaler Internet Access (ZIA)
  3. API Docs
  4. getSubCloud
Zscaler Internet Access v1.2.0 published on Friday, Feb 20, 2026 by Zscaler
zia logo
Zscaler Internet Access v1.2.0 published on Friday, Feb 20, 2026 by Zscaler

    Use the zia_sub_cloud data source to get information about a subcloud available in the Zscaler Internet Access cloud. Summary of the subcloud associated with an organization. This also represents the data centers that are excluded and associated with the subcloud.

    NOTE: This an Early Access feature.

    Example Usage

    Retrieve By Name

    data "zia_sub_cloud" "this" {
        name = "SubCloud01"
    }
    

    Retrieve By ID

    data "zia_sub_cloud" "this" {
        id = 1254674585
    }
    

    Using getSubCloud

    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 getSubCloud(args: GetSubCloudArgs, opts?: InvokeOptions): Promise<GetSubCloudResult>
    function getSubCloudOutput(args: GetSubCloudOutputArgs, opts?: InvokeOptions): Output<GetSubCloudResult>
    def get_sub_cloud(id: Optional[int] = None,
                      name: Optional[str] = None,
                      opts: Optional[InvokeOptions] = None) -> GetSubCloudResult
    def get_sub_cloud_output(id: Optional[pulumi.Input[int]] = None,
                      name: Optional[pulumi.Input[str]] = None,
                      opts: Optional[InvokeOptions] = None) -> Output[GetSubCloudResult]
    func LookupSubCloud(ctx *Context, args *LookupSubCloudArgs, opts ...InvokeOption) (*LookupSubCloudResult, error)
    func LookupSubCloudOutput(ctx *Context, args *LookupSubCloudOutputArgs, opts ...InvokeOption) LookupSubCloudResultOutput

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

    public static class GetSubCloud 
    {
        public static Task<GetSubCloudResult> InvokeAsync(GetSubCloudArgs args, InvokeOptions? opts = null)
        public static Output<GetSubCloudResult> Invoke(GetSubCloudInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetSubCloudResult> getSubCloud(GetSubCloudArgs args, InvokeOptions options)
    public static Output<GetSubCloudResult> getSubCloud(GetSubCloudArgs args, InvokeOptions options)
    
    fn::invoke:
      function: zia:index/getSubCloud:getSubCloud
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Id int
    (Integer) A unique identifier for an entity
    Name string
    (String) The configured name of the entity (read-only)
    Id int
    (Integer) A unique identifier for an entity
    Name string
    (String) The configured name of the entity (read-only)
    id Integer
    (Integer) A unique identifier for an entity
    name String
    (String) The configured name of the entity (read-only)
    id number
    (Integer) A unique identifier for an entity
    name string
    (String) The configured name of the entity (read-only)
    id int
    (Integer) A unique identifier for an entity
    name str
    (String) The configured name of the entity (read-only)
    id Number
    (Integer) A unique identifier for an entity
    name String
    (String) The configured name of the entity (read-only)

    getSubCloud Result

    The following output properties are available:

    Dcs List<zscaler.PulumiPackage.Zia.Outputs.GetSubCloudDc>
    (List) List of data centers associated with the subcloud
    Exclusions List<zscaler.PulumiPackage.Zia.Outputs.GetSubCloudExclusion>
    (List) List of data centers that are excluded from the subcloud. Information about data center excluded from the subcloud.
    Id int
    (Integer) A unique identifier for an entity
    Name string
    (String) The configured name of the entity (read-only)
    Dcs []GetSubCloudDc
    (List) List of data centers associated with the subcloud
    Exclusions []GetSubCloudExclusion
    (List) List of data centers that are excluded from the subcloud. Information about data center excluded from the subcloud.
    Id int
    (Integer) A unique identifier for an entity
    Name string
    (String) The configured name of the entity (read-only)
    dcs List<GetSubCloudDc>
    (List) List of data centers associated with the subcloud
    exclusions List<GetSubCloudExclusion>
    (List) List of data centers that are excluded from the subcloud. Information about data center excluded from the subcloud.
    id Integer
    (Integer) A unique identifier for an entity
    name String
    (String) The configured name of the entity (read-only)
    dcs GetSubCloudDc[]
    (List) List of data centers associated with the subcloud
    exclusions GetSubCloudExclusion[]
    (List) List of data centers that are excluded from the subcloud. Information about data center excluded from the subcloud.
    id number
    (Integer) A unique identifier for an entity
    name string
    (String) The configured name of the entity (read-only)
    dcs Sequence[GetSubCloudDc]
    (List) List of data centers associated with the subcloud
    exclusions Sequence[GetSubCloudExclusion]
    (List) List of data centers that are excluded from the subcloud. Information about data center excluded from the subcloud.
    id int
    (Integer) A unique identifier for an entity
    name str
    (String) The configured name of the entity (read-only)
    dcs List<Property Map>
    (List) List of data centers associated with the subcloud
    exclusions List<Property Map>
    (List) List of data centers that are excluded from the subcloud. Information about data center excluded from the subcloud.
    id Number
    (Integer) A unique identifier for an entity
    name String
    (String) The configured name of the entity (read-only)

    Supporting Types

    GetSubCloudDc

    Country string
    (String) Country where the data center is located. Enum with 245 predefined country values.
    Id int
    (Integer) A unique identifier for an entity
    Name string
    (String) The configured name of the entity (read-only)
    Country string
    (String) Country where the data center is located. Enum with 245 predefined country values.
    Id int
    (Integer) A unique identifier for an entity
    Name string
    (String) The configured name of the entity (read-only)
    country String
    (String) Country where the data center is located. Enum with 245 predefined country values.
    id Integer
    (Integer) A unique identifier for an entity
    name String
    (String) The configured name of the entity (read-only)
    country string
    (String) Country where the data center is located. Enum with 245 predefined country values.
    id number
    (Integer) A unique identifier for an entity
    name string
    (String) The configured name of the entity (read-only)
    country str
    (String) Country where the data center is located. Enum with 245 predefined country values.
    id int
    (Integer) A unique identifier for an entity
    name str
    (String) The configured name of the entity (read-only)
    country String
    (String) Country where the data center is located. Enum with 245 predefined country values.
    id Number
    (Integer) A unique identifier for an entity
    name String
    (String) The configured name of the entity (read-only)

    GetSubCloudExclusion

    Country string
    (String) Country where the data center is located. Enum with 245 predefined country values.
    CreateTime int
    (Integer) Timestamp when the data center exclusion was created
    Datacenters List<zscaler.PulumiPackage.Zia.Inputs.GetSubCloudExclusionDatacenter>
    (List) The data center associated with the subcloud. An immutable reference to an entity that mainly consists of id and name.
    DisabledByOps bool
    (Boolean) If set to true, this data center exclusion is disabled by Zscaler CloudOps
    EndTime int
    (Integer) Timestamp when the data center exclusion was stopped
    EndTimeUtc string
    Exclusion end time (UTC). Format: MM/DD/YYYY HH:MM am/pm.
    Expired bool
    (Boolean) The subcloud data center exclusion is disabled
    LastModifiedTime int
    (Integer) Timestamp when the data center exclusion entry was last modified
    LastModifiedUsers List<zscaler.PulumiPackage.Zia.Inputs.GetSubCloudExclusionLastModifiedUser>
    (List) Last user that modified the data center. An immutable reference to an entity that mainly consists of id and name.
    StartTime int
    (Integer) Timestamp when the data center exclusion was started
    StartTimeUtc string
    Exclusion start time (UTC). Format: MM/DD/YYYY HH:MM am/pm.
    Country string
    (String) Country where the data center is located. Enum with 245 predefined country values.
    CreateTime int
    (Integer) Timestamp when the data center exclusion was created
    Datacenters []GetSubCloudExclusionDatacenter
    (List) The data center associated with the subcloud. An immutable reference to an entity that mainly consists of id and name.
    DisabledByOps bool
    (Boolean) If set to true, this data center exclusion is disabled by Zscaler CloudOps
    EndTime int
    (Integer) Timestamp when the data center exclusion was stopped
    EndTimeUtc string
    Exclusion end time (UTC). Format: MM/DD/YYYY HH:MM am/pm.
    Expired bool
    (Boolean) The subcloud data center exclusion is disabled
    LastModifiedTime int
    (Integer) Timestamp when the data center exclusion entry was last modified
    LastModifiedUsers []GetSubCloudExclusionLastModifiedUser
    (List) Last user that modified the data center. An immutable reference to an entity that mainly consists of id and name.
    StartTime int
    (Integer) Timestamp when the data center exclusion was started
    StartTimeUtc string
    Exclusion start time (UTC). Format: MM/DD/YYYY HH:MM am/pm.
    country String
    (String) Country where the data center is located. Enum with 245 predefined country values.
    createTime Integer
    (Integer) Timestamp when the data center exclusion was created
    datacenters List<GetSubCloudExclusionDatacenter>
    (List) The data center associated with the subcloud. An immutable reference to an entity that mainly consists of id and name.
    disabledByOps Boolean
    (Boolean) If set to true, this data center exclusion is disabled by Zscaler CloudOps
    endTime Integer
    (Integer) Timestamp when the data center exclusion was stopped
    endTimeUtc String
    Exclusion end time (UTC). Format: MM/DD/YYYY HH:MM am/pm.
    expired Boolean
    (Boolean) The subcloud data center exclusion is disabled
    lastModifiedTime Integer
    (Integer) Timestamp when the data center exclusion entry was last modified
    lastModifiedUsers List<GetSubCloudExclusionLastModifiedUser>
    (List) Last user that modified the data center. An immutable reference to an entity that mainly consists of id and name.
    startTime Integer
    (Integer) Timestamp when the data center exclusion was started
    startTimeUtc String
    Exclusion start time (UTC). Format: MM/DD/YYYY HH:MM am/pm.
    country string
    (String) Country where the data center is located. Enum with 245 predefined country values.
    createTime number
    (Integer) Timestamp when the data center exclusion was created
    datacenters GetSubCloudExclusionDatacenter[]
    (List) The data center associated with the subcloud. An immutable reference to an entity that mainly consists of id and name.
    disabledByOps boolean
    (Boolean) If set to true, this data center exclusion is disabled by Zscaler CloudOps
    endTime number
    (Integer) Timestamp when the data center exclusion was stopped
    endTimeUtc string
    Exclusion end time (UTC). Format: MM/DD/YYYY HH:MM am/pm.
    expired boolean
    (Boolean) The subcloud data center exclusion is disabled
    lastModifiedTime number
    (Integer) Timestamp when the data center exclusion entry was last modified
    lastModifiedUsers GetSubCloudExclusionLastModifiedUser[]
    (List) Last user that modified the data center. An immutable reference to an entity that mainly consists of id and name.
    startTime number
    (Integer) Timestamp when the data center exclusion was started
    startTimeUtc string
    Exclusion start time (UTC). Format: MM/DD/YYYY HH:MM am/pm.
    country str
    (String) Country where the data center is located. Enum with 245 predefined country values.
    create_time int
    (Integer) Timestamp when the data center exclusion was created
    datacenters Sequence[GetSubCloudExclusionDatacenter]
    (List) The data center associated with the subcloud. An immutable reference to an entity that mainly consists of id and name.
    disabled_by_ops bool
    (Boolean) If set to true, this data center exclusion is disabled by Zscaler CloudOps
    end_time int
    (Integer) Timestamp when the data center exclusion was stopped
    end_time_utc str
    Exclusion end time (UTC). Format: MM/DD/YYYY HH:MM am/pm.
    expired bool
    (Boolean) The subcloud data center exclusion is disabled
    last_modified_time int
    (Integer) Timestamp when the data center exclusion entry was last modified
    last_modified_users Sequence[GetSubCloudExclusionLastModifiedUser]
    (List) Last user that modified the data center. An immutable reference to an entity that mainly consists of id and name.
    start_time int
    (Integer) Timestamp when the data center exclusion was started
    start_time_utc str
    Exclusion start time (UTC). Format: MM/DD/YYYY HH:MM am/pm.
    country String
    (String) Country where the data center is located. Enum with 245 predefined country values.
    createTime Number
    (Integer) Timestamp when the data center exclusion was created
    datacenters List<Property Map>
    (List) The data center associated with the subcloud. An immutable reference to an entity that mainly consists of id and name.
    disabledByOps Boolean
    (Boolean) If set to true, this data center exclusion is disabled by Zscaler CloudOps
    endTime Number
    (Integer) Timestamp when the data center exclusion was stopped
    endTimeUtc String
    Exclusion end time (UTC). Format: MM/DD/YYYY HH:MM am/pm.
    expired Boolean
    (Boolean) The subcloud data center exclusion is disabled
    lastModifiedTime Number
    (Integer) Timestamp when the data center exclusion entry was last modified
    lastModifiedUsers List<Property Map>
    (List) Last user that modified the data center. An immutable reference to an entity that mainly consists of id and name.
    startTime Number
    (Integer) Timestamp when the data center exclusion was started
    startTimeUtc String
    Exclusion start time (UTC). Format: MM/DD/YYYY HH:MM am/pm.

    GetSubCloudExclusionDatacenter

    Extensions Dictionary<string, string>
    (Map of String) Extension attributes
    Id int
    (Integer) A unique identifier for an entity
    Name string
    (String) The configured name of the entity (read-only)
    Extensions map[string]string
    (Map of String) Extension attributes
    Id int
    (Integer) A unique identifier for an entity
    Name string
    (String) The configured name of the entity (read-only)
    extensions Map<String,String>
    (Map of String) Extension attributes
    id Integer
    (Integer) A unique identifier for an entity
    name String
    (String) The configured name of the entity (read-only)
    extensions {[key: string]: string}
    (Map of String) Extension attributes
    id number
    (Integer) A unique identifier for an entity
    name string
    (String) The configured name of the entity (read-only)
    extensions Mapping[str, str]
    (Map of String) Extension attributes
    id int
    (Integer) A unique identifier for an entity
    name str
    (String) The configured name of the entity (read-only)
    extensions Map<String>
    (Map of String) Extension attributes
    id Number
    (Integer) A unique identifier for an entity
    name String
    (String) The configured name of the entity (read-only)

    GetSubCloudExclusionLastModifiedUser

    Extensions Dictionary<string, string>
    (Map of String) Extension attributes
    Id int
    (Integer) A unique identifier for an entity
    Name string
    (String) The configured name of the entity (read-only)
    Extensions map[string]string
    (Map of String) Extension attributes
    Id int
    (Integer) A unique identifier for an entity
    Name string
    (String) The configured name of the entity (read-only)
    extensions Map<String,String>
    (Map of String) Extension attributes
    id Integer
    (Integer) A unique identifier for an entity
    name String
    (String) The configured name of the entity (read-only)
    extensions {[key: string]: string}
    (Map of String) Extension attributes
    id number
    (Integer) A unique identifier for an entity
    name string
    (String) The configured name of the entity (read-only)
    extensions Mapping[str, str]
    (Map of String) Extension attributes
    id int
    (Integer) A unique identifier for an entity
    name str
    (String) The configured name of the entity (read-only)
    extensions Map<String>
    (Map of String) Extension attributes
    id Number
    (Integer) A unique identifier for an entity
    name String
    (String) The configured name of the entity (read-only)

    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
      Meet Neo: Your AI Platform Teammate