1. Packages
  2. Strata Cloud Manager Provider
  3. API Docs
  4. getZone
Strata Cloud Manager v0.4.3 published on Saturday, Nov 8, 2025 by Pulumi
scm logo
Strata Cloud Manager v0.4.3 published on Saturday, Nov 8, 2025 by Pulumi

    Zone data source

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as scm from "@pulumi/scm";
    
    // Look up zone by its ID.
    const scmZoneDs = scm.getZone({
        id: "50f1f0f3-a420-4989-9770-c927f1467a9a",
    });
    export const zoneDataSourceResults = {
        id: scmZoneDs.then(scmZoneDs => scmZoneDs.id),
        name: scmZoneDs.then(scmZoneDs => scmZoneDs.name),
        network: scmZoneDs.then(scmZoneDs => scmZoneDs.network),
        enableDeviceIdentification: scmZoneDs.then(scmZoneDs => scmZoneDs.enableDeviceIdentification),
        enableUserIdentification: scmZoneDs.then(scmZoneDs => scmZoneDs.enableUserIdentification),
        userAcl: scmZoneDs.then(scmZoneDs => scmZoneDs.userAcl),
        deviceAcl: scmZoneDs.then(scmZoneDs => scmZoneDs.deviceAcl),
        folder: scmZoneDs.then(scmZoneDs => scmZoneDs.folder),
    };
    
    import pulumi
    import pulumi_scm as scm
    
    # Look up zone by its ID.
    scm_zone_ds = scm.get_zone(id="50f1f0f3-a420-4989-9770-c927f1467a9a")
    pulumi.export("zoneDataSourceResults", {
        "id": scm_zone_ds.id,
        "name": scm_zone_ds.name,
        "network": scm_zone_ds.network,
        "enableDeviceIdentification": scm_zone_ds.enable_device_identification,
        "enableUserIdentification": scm_zone_ds.enable_user_identification,
        "userAcl": scm_zone_ds.user_acl,
        "deviceAcl": scm_zone_ds.device_acl,
        "folder": scm_zone_ds.folder,
    })
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-scm/sdk/go/scm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// Look up zone by its ID.
    		scmZoneDs, err := scm.LookupZone(ctx, &scm.LookupZoneArgs{
    			Id: "50f1f0f3-a420-4989-9770-c927f1467a9a",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		ctx.Export("zoneDataSourceResults", pulumi.Map{
    			"id":                         scmZoneDs.Id,
    			"name":                       scmZoneDs.Name,
    			"network":                    scmZoneDs.Network,
    			"enableDeviceIdentification": scmZoneDs.EnableDeviceIdentification,
    			"enableUserIdentification":   scmZoneDs.EnableUserIdentification,
    			"userAcl":                    scmZoneDs.UserAcl,
    			"deviceAcl":                  scmZoneDs.DeviceAcl,
    			"folder":                     scmZoneDs.Folder,
    		})
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Scm = Pulumi.Scm;
    
    return await Deployment.RunAsync(() => 
    {
        // Look up zone by its ID.
        var scmZoneDs = Scm.GetZone.Invoke(new()
        {
            Id = "50f1f0f3-a420-4989-9770-c927f1467a9a",
        });
    
        return new Dictionary<string, object?>
        {
            ["zoneDataSourceResults"] = 
            {
                { "id", scmZoneDs.Apply(getZoneResult => getZoneResult.Id) },
                { "name", scmZoneDs.Apply(getZoneResult => getZoneResult.Name) },
                { "network", scmZoneDs.Apply(getZoneResult => getZoneResult.Network) },
                { "enableDeviceIdentification", scmZoneDs.Apply(getZoneResult => getZoneResult.EnableDeviceIdentification) },
                { "enableUserIdentification", scmZoneDs.Apply(getZoneResult => getZoneResult.EnableUserIdentification) },
                { "userAcl", scmZoneDs.Apply(getZoneResult => getZoneResult.UserAcl) },
                { "deviceAcl", scmZoneDs.Apply(getZoneResult => getZoneResult.DeviceAcl) },
                { "folder", scmZoneDs.Apply(getZoneResult => getZoneResult.Folder) },
            },
        };
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.scm.ScmFunctions;
    import com.pulumi.scm.inputs.GetZoneArgs;
    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) {
            // Look up zone by its ID.
            final var scmZoneDs = ScmFunctions.getZone(GetZoneArgs.builder()
                .id("50f1f0f3-a420-4989-9770-c927f1467a9a")
                .build());
    
            ctx.export("zoneDataSourceResults", Map.ofEntries(
                Map.entry("id", scmZoneDs.id()),
                Map.entry("name", scmZoneDs.name()),
                Map.entry("network", scmZoneDs.network()),
                Map.entry("enableDeviceIdentification", scmZoneDs.enableDeviceIdentification()),
                Map.entry("enableUserIdentification", scmZoneDs.enableUserIdentification()),
                Map.entry("userAcl", scmZoneDs.userAcl()),
                Map.entry("deviceAcl", scmZoneDs.deviceAcl()),
                Map.entry("folder", scmZoneDs.folder())
            ));
        }
    }
    
    variables:
      # Look up zone by its ID.
      scmZoneDs:
        fn::invoke:
          function: scm:getZone
          arguments:
            id: 50f1f0f3-a420-4989-9770-c927f1467a9a
    outputs:
      # Output various attributes from the found zone to verify the lookups were successful.
      zoneDataSourceResults:
        id: ${scmZoneDs.id}
        name: ${scmZoneDs.name}
        network: ${scmZoneDs.network}
        enableDeviceIdentification: ${scmZoneDs.enableDeviceIdentification}
        enableUserIdentification: ${scmZoneDs.enableUserIdentification}
        userAcl: ${scmZoneDs.userAcl}
        deviceAcl: ${scmZoneDs.deviceAcl}
        folder: ${scmZoneDs.folder}
    

    Using getZone

    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 getZone(args: GetZoneArgs, opts?: InvokeOptions): Promise<GetZoneResult>
    function getZoneOutput(args: GetZoneOutputArgs, opts?: InvokeOptions): Output<GetZoneResult>
    def get_zone(id: Optional[str] = None,
                 name: Optional[str] = None,
                 opts: Optional[InvokeOptions] = None) -> GetZoneResult
    def get_zone_output(id: Optional[pulumi.Input[str]] = None,
                 name: Optional[pulumi.Input[str]] = None,
                 opts: Optional[InvokeOptions] = None) -> Output[GetZoneResult]
    func LookupZone(ctx *Context, args *LookupZoneArgs, opts ...InvokeOption) (*LookupZoneResult, error)
    func LookupZoneOutput(ctx *Context, args *LookupZoneOutputArgs, opts ...InvokeOption) LookupZoneResultOutput

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

    public static class GetZone 
    {
        public static Task<GetZoneResult> InvokeAsync(GetZoneArgs args, InvokeOptions? opts = null)
        public static Output<GetZoneResult> Invoke(GetZoneInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetZoneResult> getZone(GetZoneArgs args, InvokeOptions options)
    public static Output<GetZoneResult> getZone(GetZoneArgs args, InvokeOptions options)
    
    fn::invoke:
      function: scm:index/getZone:getZone
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Id string
    UUID of the resource
    Name string
    Alphanumeric string begin with letter: [0-9a-zA-Z._-]
    Id string
    UUID of the resource
    Name string
    Alphanumeric string begin with letter: [0-9a-zA-Z._-]
    id String
    UUID of the resource
    name String
    Alphanumeric string begin with letter: [0-9a-zA-Z._-]
    id string
    UUID of the resource
    name string
    Alphanumeric string begin with letter: [0-9a-zA-Z._-]
    id str
    UUID of the resource
    name str
    Alphanumeric string begin with letter: [0-9a-zA-Z._-]
    id String
    UUID of the resource
    name String
    Alphanumeric string begin with letter: [0-9a-zA-Z._-]

    getZone Result

    The following output properties are available:

    Device string
    The device in which the resource is defined
    DeviceAcl GetZoneDeviceAcl
    Device acl
    DosLogSetting string
    Dos log setting
    DosProfile string
    Dos profile
    EnableDeviceIdentification bool
    Enable device identification
    EnableUserIdentification bool
    Enable user identification
    Folder string
    Folder
    Id string
    UUID of the resource
    Name string
    Alphanumeric string begin with letter: [0-9a-zA-Z._-]
    Network GetZoneNetwork
    Network
    Snippet string
    The snippet in which the resource is defined
    Tfid string
    UserAcl GetZoneUserAcl
    User acl
    Device string
    The device in which the resource is defined
    DeviceAcl GetZoneDeviceAcl
    Device acl
    DosLogSetting string
    Dos log setting
    DosProfile string
    Dos profile
    EnableDeviceIdentification bool
    Enable device identification
    EnableUserIdentification bool
    Enable user identification
    Folder string
    Folder
    Id string
    UUID of the resource
    Name string
    Alphanumeric string begin with letter: [0-9a-zA-Z._-]
    Network GetZoneNetwork
    Network
    Snippet string
    The snippet in which the resource is defined
    Tfid string
    UserAcl GetZoneUserAcl
    User acl
    device String
    The device in which the resource is defined
    deviceAcl GetZoneDeviceAcl
    Device acl
    dosLogSetting String
    Dos log setting
    dosProfile String
    Dos profile
    enableDeviceIdentification Boolean
    Enable device identification
    enableUserIdentification Boolean
    Enable user identification
    folder String
    Folder
    id String
    UUID of the resource
    name String
    Alphanumeric string begin with letter: [0-9a-zA-Z._-]
    network GetZoneNetwork
    Network
    snippet String
    The snippet in which the resource is defined
    tfid String
    userAcl GetZoneUserAcl
    User acl
    device string
    The device in which the resource is defined
    deviceAcl GetZoneDeviceAcl
    Device acl
    dosLogSetting string
    Dos log setting
    dosProfile string
    Dos profile
    enableDeviceIdentification boolean
    Enable device identification
    enableUserIdentification boolean
    Enable user identification
    folder string
    Folder
    id string
    UUID of the resource
    name string
    Alphanumeric string begin with letter: [0-9a-zA-Z._-]
    network GetZoneNetwork
    Network
    snippet string
    The snippet in which the resource is defined
    tfid string
    userAcl GetZoneUserAcl
    User acl
    device str
    The device in which the resource is defined
    device_acl GetZoneDeviceAcl
    Device acl
    dos_log_setting str
    Dos log setting
    dos_profile str
    Dos profile
    enable_device_identification bool
    Enable device identification
    enable_user_identification bool
    Enable user identification
    folder str
    Folder
    id str
    UUID of the resource
    name str
    Alphanumeric string begin with letter: [0-9a-zA-Z._-]
    network GetZoneNetwork
    Network
    snippet str
    The snippet in which the resource is defined
    tfid str
    user_acl GetZoneUserAcl
    User acl
    device String
    The device in which the resource is defined
    deviceAcl Property Map
    Device acl
    dosLogSetting String
    Dos log setting
    dosProfile String
    Dos profile
    enableDeviceIdentification Boolean
    Enable device identification
    enableUserIdentification Boolean
    Enable user identification
    folder String
    Folder
    id String
    UUID of the resource
    name String
    Alphanumeric string begin with letter: [0-9a-zA-Z._-]
    network Property Map
    Network
    snippet String
    The snippet in which the resource is defined
    tfid String
    userAcl Property Map
    User acl

    Supporting Types

    GetZoneDeviceAcl

    ExcludeLists List<string>
    Exclude list
    IncludeLists List<string>
    Include list
    ExcludeLists []string
    Exclude list
    IncludeLists []string
    Include list
    excludeLists List<String>
    Exclude list
    includeLists List<String>
    Include list
    excludeLists string[]
    Exclude list
    includeLists string[]
    Include list
    exclude_lists Sequence[str]
    Exclude list
    include_lists Sequence[str]
    Include list
    excludeLists List<String>
    Exclude list
    includeLists List<String>
    Include list

    GetZoneNetwork

    EnablePacketBufferProtection bool
    Enable packet buffer protection
    Externals List<string>
    External
    Layer2s List<string>
    Layer2
    Layer3s List<string>
    Layer3
    LogSetting string
    Log setting
    Taps List<string>
    Tap
    Tunnel GetZoneNetworkTunnel
    Tunnel
    VirtualWires List<string>
    Virtual wire
    ZoneProtectionProfile string
    Zone protection profile
    EnablePacketBufferProtection bool
    Enable packet buffer protection
    Externals []string
    External
    Layer2s []string
    Layer2
    Layer3s []string
    Layer3
    LogSetting string
    Log setting
    Taps []string
    Tap
    Tunnel GetZoneNetworkTunnel
    Tunnel
    VirtualWires []string
    Virtual wire
    ZoneProtectionProfile string
    Zone protection profile
    enablePacketBufferProtection Boolean
    Enable packet buffer protection
    externals List<String>
    External
    layer2s List<String>
    Layer2
    layer3s List<String>
    Layer3
    logSetting String
    Log setting
    taps List<String>
    Tap
    tunnel GetZoneNetworkTunnel
    Tunnel
    virtualWires List<String>
    Virtual wire
    zoneProtectionProfile String
    Zone protection profile
    enablePacketBufferProtection boolean
    Enable packet buffer protection
    externals string[]
    External
    layer2s string[]
    Layer2
    layer3s string[]
    Layer3
    logSetting string
    Log setting
    taps string[]
    Tap
    tunnel GetZoneNetworkTunnel
    Tunnel
    virtualWires string[]
    Virtual wire
    zoneProtectionProfile string
    Zone protection profile
    enable_packet_buffer_protection bool
    Enable packet buffer protection
    externals Sequence[str]
    External
    layer2s Sequence[str]
    Layer2
    layer3s Sequence[str]
    Layer3
    log_setting str
    Log setting
    taps Sequence[str]
    Tap
    tunnel GetZoneNetworkTunnel
    Tunnel
    virtual_wires Sequence[str]
    Virtual wire
    zone_protection_profile str
    Zone protection profile
    enablePacketBufferProtection Boolean
    Enable packet buffer protection
    externals List<String>
    External
    layer2s List<String>
    Layer2
    layer3s List<String>
    Layer3
    logSetting String
    Log setting
    taps List<String>
    Tap
    tunnel Property Map
    Tunnel
    virtualWires List<String>
    Virtual wire
    zoneProtectionProfile String
    Zone protection profile

    GetZoneUserAcl

    ExcludeLists List<string>
    Exclude list
    IncludeLists List<string>
    Include list
    ExcludeLists []string
    Exclude list
    IncludeLists []string
    Include list
    excludeLists List<String>
    Exclude list
    includeLists List<String>
    Include list
    excludeLists string[]
    Exclude list
    includeLists string[]
    Include list
    exclude_lists Sequence[str]
    Exclude list
    include_lists Sequence[str]
    Include list
    excludeLists List<String>
    Exclude list
    includeLists List<String>
    Include list

    Package Details

    Repository
    scm pulumi/pulumi-scm
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the scm Terraform Provider.
    scm logo
    Strata Cloud Manager v0.4.3 published on Saturday, Nov 8, 2025 by Pulumi
      Meet Neo: Your AI Platform Teammate