Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Powerscale Provider
  3. API Docs
  4. Groupnet
powerscale 1.7.0 published on Monday, Apr 14, 2025 by dell
dell/terraform-provider-powerscale

powerscale.Groupnet

Explore with Pulumi AI

powerscale 1.7.0 published on Monday, Apr 14, 2025 by dell
dell/terraform-provider-powerscale

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", {});
Copy
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")
Copy
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
	})
}
Copy
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");

});
Copy
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");

    }
}
Copy
resources:
  # PowerScale Groupnet sits above subnets and pools and allows separate Access Zones to contain distinct DNS settings.
  exampleGroupnet:
    type: powerscale:Groupnet
Copy

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 This property is required. 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 This property is required. 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 This property is required. 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 This property is required. 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 This property is required. String
The unique name of the resource.
args This property is required. 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,
});
Copy
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),
})
Copy
var groupnetResource = new Groupnet("groupnetResource", GroupnetArgs.builder()
    .allowWildcardSubdomains(false)
    .description("string")
    .dnsCacheEnabled(false)
    .dnsResolverRotate(false)
    .dnsSearches("string")
    .dnsServers("string")
    .name("string")
    .serverSideDnsSearch(false)
    .build());
Copy
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)
Copy
const groupnetResource = new powerscale.Groupnet("groupnetResource", {
    allowWildcardSubdomains: false,
    description: "string",
    dnsCacheEnabled: false,
    dnsResolverRotate: false,
    dnsSearches: ["string"],
    dnsServers: ["string"],
    name: "string",
    serverSideDnsSearch: false,
});
Copy
type: powerscale:Groupnet
properties:
    allowWildcardSubdomains: false
    description: string
    dnsCacheEnabled: false
    dnsResolverRotate: false
    dnsSearches:
        - string
    dnsServers:
        - string
    name: string
    serverSideDnsSearch: false
Copy

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 This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
name This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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>
Copy

Example:

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

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 1.7.0 published on Monday, Apr 14, 2025 by dell
dell/terraform-provider-powerscale