1. Packages
  2. Powerscale Provider
  3. API Docs
  4. Groupnet
powerscale 1.7.0 published on Monday, Apr 14, 2025 by dell

powerscale.Groupnet

Explore with Pulumi AI

powerscale logo
powerscale 1.7.0 published on Monday, Apr 14, 2025 by dell

    This resource is used to manage the Groupnet entity of PowerScale Array. We can Create, Update and Delete the Groupnet using this resource. We can also import an existing Groupnet from PowerScale array. PowerScale Groupnet sits above subnets and pools and allows separate Access Zones to contain distinct DNS settings.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as powerscale from "@pulumi/powerscale";
    
    // PowerScale Groupnet sits above subnets and pools and allows separate Access Zones to contain distinct DNS settings.
    const exampleGroupnet = new powerscale.Groupnet("exampleGroupnet", {});
    
    import pulumi
    import pulumi_powerscale as powerscale
    
    # PowerScale Groupnet sits above subnets and pools and allows separate Access Zones to contain distinct DNS settings.
    example_groupnet = powerscale.Groupnet("exampleGroupnet")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/powerscale/powerscale"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// PowerScale Groupnet sits above subnets and pools and allows separate Access Zones to contain distinct DNS settings.
    		_, err := powerscale.NewGroupnet(ctx, "exampleGroupnet", nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Powerscale = Pulumi.Powerscale;
    
    return await Deployment.RunAsync(() => 
    {
        // PowerScale Groupnet sits above subnets and pools and allows separate Access Zones to contain distinct DNS settings.
        var exampleGroupnet = new Powerscale.Groupnet("exampleGroupnet");
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.powerscale.Groupnet;
    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) {
            // PowerScale Groupnet sits above subnets and pools and allows separate Access Zones to contain distinct DNS settings.
            var exampleGroupnet = new Groupnet("exampleGroupnet");
    
        }
    }
    
    resources:
      # PowerScale Groupnet sits above subnets and pools and allows separate Access Zones to contain distinct DNS settings.
      exampleGroupnet:
        type: powerscale:Groupnet
    

    Create Groupnet Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Groupnet(name: string, args?: GroupnetArgs, opts?: CustomResourceOptions);
    @overload
    def Groupnet(resource_name: str,
                 args: Optional[GroupnetArgs] = None,
                 opts: Optional[ResourceOptions] = None)
    
    @overload
    def Groupnet(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 allow_wildcard_subdomains: Optional[bool] = None,
                 description: Optional[str] = None,
                 dns_cache_enabled: Optional[bool] = None,
                 dns_resolver_rotate: Optional[bool] = None,
                 dns_searches: Optional[Sequence[str]] = None,
                 dns_servers: Optional[Sequence[str]] = None,
                 name: Optional[str] = None,
                 server_side_dns_search: Optional[bool] = None)
    func NewGroupnet(ctx *Context, name string, args *GroupnetArgs, opts ...ResourceOption) (*Groupnet, error)
    public Groupnet(string name, GroupnetArgs? args = null, CustomResourceOptions? opts = null)
    public Groupnet(String name, GroupnetArgs args)
    public Groupnet(String name, GroupnetArgs args, CustomResourceOptions options)
    
    type: powerscale:Groupnet
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args GroupnetArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args GroupnetArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args GroupnetArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args GroupnetArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args GroupnetArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var groupnetResource = new Powerscale.Groupnet("groupnetResource", new()
    {
        AllowWildcardSubdomains = false,
        Description = "string",
        DnsCacheEnabled = false,
        DnsResolverRotate = false,
        DnsSearches = new[]
        {
            "string",
        },
        DnsServers = new[]
        {
            "string",
        },
        Name = "string",
        ServerSideDnsSearch = false,
    });
    
    example, err := powerscale.NewGroupnet(ctx, "groupnetResource", &powerscale.GroupnetArgs{
    	AllowWildcardSubdomains: pulumi.Bool(false),
    	Description:             pulumi.String("string"),
    	DnsCacheEnabled:         pulumi.Bool(false),
    	DnsResolverRotate:       pulumi.Bool(false),
    	DnsSearches: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	DnsServers: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Name:                pulumi.String("string"),
    	ServerSideDnsSearch: pulumi.Bool(false),
    })
    
    var groupnetResource = new Groupnet("groupnetResource", GroupnetArgs.builder()
        .allowWildcardSubdomains(false)
        .description("string")
        .dnsCacheEnabled(false)
        .dnsResolverRotate(false)
        .dnsSearches("string")
        .dnsServers("string")
        .name("string")
        .serverSideDnsSearch(false)
        .build());
    
    groupnet_resource = powerscale.Groupnet("groupnetResource",
        allow_wildcard_subdomains=False,
        description="string",
        dns_cache_enabled=False,
        dns_resolver_rotate=False,
        dns_searches=["string"],
        dns_servers=["string"],
        name="string",
        server_side_dns_search=False)
    
    const groupnetResource = new powerscale.Groupnet("groupnetResource", {
        allowWildcardSubdomains: false,
        description: "string",
        dnsCacheEnabled: false,
        dnsResolverRotate: false,
        dnsSearches: ["string"],
        dnsServers: ["string"],
        name: "string",
        serverSideDnsSearch: false,
    });
    
    type: powerscale:Groupnet
    properties:
        allowWildcardSubdomains: false
        description: string
        dnsCacheEnabled: false
        dnsResolverRotate: false
        dnsSearches:
            - string
        dnsServers:
            - string
        name: string
        serverSideDnsSearch: false
    

    Groupnet Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Groupnet resource accepts the following input properties:

    AllowWildcardSubdomains bool
    If enabled, SmartConnect treats subdomains of known dns zones as the known dns zone. This is required for S3 Virtual Host domains. Defaults to True.
    Description string
    A description of the groupnet.
    DnsCacheEnabled bool
    DNS caching is enabled or disabled. Defaults to True.
    DnsResolverRotate bool
    Enable or disable DNS resolver rotate. Defaults to False.
    DnsSearches List<string>
    List of DNS search suffixes.
    DnsServers List<string>
    List of Domain Name Server IP addresses.
    Name string
    The name of the groupnet.
    ServerSideDnsSearch bool
    Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
    AllowWildcardSubdomains bool
    If enabled, SmartConnect treats subdomains of known dns zones as the known dns zone. This is required for S3 Virtual Host domains. Defaults to True.
    Description string
    A description of the groupnet.
    DnsCacheEnabled bool
    DNS caching is enabled or disabled. Defaults to True.
    DnsResolverRotate bool
    Enable or disable DNS resolver rotate. Defaults to False.
    DnsSearches []string
    List of DNS search suffixes.
    DnsServers []string
    List of Domain Name Server IP addresses.
    Name string
    The name of the groupnet.
    ServerSideDnsSearch bool
    Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
    allowWildcardSubdomains Boolean
    If enabled, SmartConnect treats subdomains of known dns zones as the known dns zone. This is required for S3 Virtual Host domains. Defaults to True.
    description String
    A description of the groupnet.
    dnsCacheEnabled Boolean
    DNS caching is enabled or disabled. Defaults to True.
    dnsResolverRotate Boolean
    Enable or disable DNS resolver rotate. Defaults to False.
    dnsSearches List<String>
    List of DNS search suffixes.
    dnsServers List<String>
    List of Domain Name Server IP addresses.
    name String
    The name of the groupnet.
    serverSideDnsSearch Boolean
    Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
    allowWildcardSubdomains boolean
    If enabled, SmartConnect treats subdomains of known dns zones as the known dns zone. This is required for S3 Virtual Host domains. Defaults to True.
    description string
    A description of the groupnet.
    dnsCacheEnabled boolean
    DNS caching is enabled or disabled. Defaults to True.
    dnsResolverRotate boolean
    Enable or disable DNS resolver rotate. Defaults to False.
    dnsSearches string[]
    List of DNS search suffixes.
    dnsServers string[]
    List of Domain Name Server IP addresses.
    name string
    The name of the groupnet.
    serverSideDnsSearch boolean
    Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
    allow_wildcard_subdomains bool
    If enabled, SmartConnect treats subdomains of known dns zones as the known dns zone. This is required for S3 Virtual Host domains. Defaults to True.
    description str
    A description of the groupnet.
    dns_cache_enabled bool
    DNS caching is enabled or disabled. Defaults to True.
    dns_resolver_rotate bool
    Enable or disable DNS resolver rotate. Defaults to False.
    dns_searches Sequence[str]
    List of DNS search suffixes.
    dns_servers Sequence[str]
    List of Domain Name Server IP addresses.
    name str
    The name of the groupnet.
    server_side_dns_search bool
    Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
    allowWildcardSubdomains Boolean
    If enabled, SmartConnect treats subdomains of known dns zones as the known dns zone. This is required for S3 Virtual Host domains. Defaults to True.
    description String
    A description of the groupnet.
    dnsCacheEnabled Boolean
    DNS caching is enabled or disabled. Defaults to True.
    dnsResolverRotate Boolean
    Enable or disable DNS resolver rotate. Defaults to False.
    dnsSearches List<String>
    List of DNS search suffixes.
    dnsServers List<String>
    List of Domain Name Server IP addresses.
    name String
    The name of the groupnet.
    serverSideDnsSearch Boolean
    Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Groupnet resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Subnets List<string>
    Name of the subnets in the groupnet.
    Id string
    The provider-assigned unique ID for this managed resource.
    Subnets []string
    Name of the subnets in the groupnet.
    id String
    The provider-assigned unique ID for this managed resource.
    subnets List<String>
    Name of the subnets in the groupnet.
    id string
    The provider-assigned unique ID for this managed resource.
    subnets string[]
    Name of the subnets in the groupnet.
    id str
    The provider-assigned unique ID for this managed resource.
    subnets Sequence[str]
    Name of the subnets in the groupnet.
    id String
    The provider-assigned unique ID for this managed resource.
    subnets List<String>
    Name of the subnets in the groupnet.

    Look up Existing Groupnet Resource

    Get an existing Groupnet resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: GroupnetState, opts?: CustomResourceOptions): Groupnet
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            allow_wildcard_subdomains: Optional[bool] = None,
            description: Optional[str] = None,
            dns_cache_enabled: Optional[bool] = None,
            dns_resolver_rotate: Optional[bool] = None,
            dns_searches: Optional[Sequence[str]] = None,
            dns_servers: Optional[Sequence[str]] = None,
            name: Optional[str] = None,
            server_side_dns_search: Optional[bool] = None,
            subnets: Optional[Sequence[str]] = None) -> Groupnet
    func GetGroupnet(ctx *Context, name string, id IDInput, state *GroupnetState, opts ...ResourceOption) (*Groupnet, error)
    public static Groupnet Get(string name, Input<string> id, GroupnetState? state, CustomResourceOptions? opts = null)
    public static Groupnet get(String name, Output<String> id, GroupnetState state, CustomResourceOptions options)
    resources:  _:    type: powerscale:Groupnet    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AllowWildcardSubdomains bool
    If enabled, SmartConnect treats subdomains of known dns zones as the known dns zone. This is required for S3 Virtual Host domains. Defaults to True.
    Description string
    A description of the groupnet.
    DnsCacheEnabled bool
    DNS caching is enabled or disabled. Defaults to True.
    DnsResolverRotate bool
    Enable or disable DNS resolver rotate. Defaults to False.
    DnsSearches List<string>
    List of DNS search suffixes.
    DnsServers List<string>
    List of Domain Name Server IP addresses.
    Name string
    The name of the groupnet.
    ServerSideDnsSearch bool
    Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
    Subnets List<string>
    Name of the subnets in the groupnet.
    AllowWildcardSubdomains bool
    If enabled, SmartConnect treats subdomains of known dns zones as the known dns zone. This is required for S3 Virtual Host domains. Defaults to True.
    Description string
    A description of the groupnet.
    DnsCacheEnabled bool
    DNS caching is enabled or disabled. Defaults to True.
    DnsResolverRotate bool
    Enable or disable DNS resolver rotate. Defaults to False.
    DnsSearches []string
    List of DNS search suffixes.
    DnsServers []string
    List of Domain Name Server IP addresses.
    Name string
    The name of the groupnet.
    ServerSideDnsSearch bool
    Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
    Subnets []string
    Name of the subnets in the groupnet.
    allowWildcardSubdomains Boolean
    If enabled, SmartConnect treats subdomains of known dns zones as the known dns zone. This is required for S3 Virtual Host domains. Defaults to True.
    description String
    A description of the groupnet.
    dnsCacheEnabled Boolean
    DNS caching is enabled or disabled. Defaults to True.
    dnsResolverRotate Boolean
    Enable or disable DNS resolver rotate. Defaults to False.
    dnsSearches List<String>
    List of DNS search suffixes.
    dnsServers List<String>
    List of Domain Name Server IP addresses.
    name String
    The name of the groupnet.
    serverSideDnsSearch Boolean
    Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
    subnets List<String>
    Name of the subnets in the groupnet.
    allowWildcardSubdomains boolean
    If enabled, SmartConnect treats subdomains of known dns zones as the known dns zone. This is required for S3 Virtual Host domains. Defaults to True.
    description string
    A description of the groupnet.
    dnsCacheEnabled boolean
    DNS caching is enabled or disabled. Defaults to True.
    dnsResolverRotate boolean
    Enable or disable DNS resolver rotate. Defaults to False.
    dnsSearches string[]
    List of DNS search suffixes.
    dnsServers string[]
    List of Domain Name Server IP addresses.
    name string
    The name of the groupnet.
    serverSideDnsSearch boolean
    Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
    subnets string[]
    Name of the subnets in the groupnet.
    allow_wildcard_subdomains bool
    If enabled, SmartConnect treats subdomains of known dns zones as the known dns zone. This is required for S3 Virtual Host domains. Defaults to True.
    description str
    A description of the groupnet.
    dns_cache_enabled bool
    DNS caching is enabled or disabled. Defaults to True.
    dns_resolver_rotate bool
    Enable or disable DNS resolver rotate. Defaults to False.
    dns_searches Sequence[str]
    List of DNS search suffixes.
    dns_servers Sequence[str]
    List of Domain Name Server IP addresses.
    name str
    The name of the groupnet.
    server_side_dns_search bool
    Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
    subnets Sequence[str]
    Name of the subnets in the groupnet.
    allowWildcardSubdomains Boolean
    If enabled, SmartConnect treats subdomains of known dns zones as the known dns zone. This is required for S3 Virtual Host domains. Defaults to True.
    description String
    A description of the groupnet.
    dnsCacheEnabled Boolean
    DNS caching is enabled or disabled. Defaults to True.
    dnsResolverRotate Boolean
    Enable or disable DNS resolver rotate. Defaults to False.
    dnsSearches List<String>
    List of DNS search suffixes.
    dnsServers List<String>
    List of Domain Name Server IP addresses.
    name String
    The name of the groupnet.
    serverSideDnsSearch Boolean
    Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
    subnets List<String>
    Name of the subnets in the groupnet.

    Import

    Copyright (c) 2023-2024 Dell Inc., or its subsidiaries. All Rights Reserved.

    Licensed under the Mozilla Public License Version 2.0 (the “License”);

    you may not use this file except in compliance with the License.

    You may obtain a copy of the License at

    http://mozilla.org/MPL/2.0/
    

    Unless required by applicable law or agreed to in writing, software

    distributed under the License is distributed on an “AS IS” BASIS,

    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    See the License for the specific language governing permissions and

    limitations under the License.

    The command is

    $ pulumi import powerscale:index/groupnet:Groupnet example_groupnet <groupnetName>
    

    Example:

    $ pulumi import powerscale:index/groupnet:Groupnet example_groupnet groupnetName
    

    after running this command, populate the name field and other required parameters in the config file to start managing this resource.

    Note: running “terraform show” after importing shows the current config/state of the resource. You can copy/paste that config to make it easier to manage the resource.

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    powerscale dell/terraform-provider-powerscale
    License
    Notes
    This Pulumi package is based on the powerscale Terraform Provider.
    powerscale logo
    powerscale 1.7.0 published on Monday, Apr 14, 2025 by dell