powerscale.Groupnet
Explore with Pulumi AI
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:
- Allow
Wildcard boolSubdomains - 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.
- Dns
Cache boolEnabled - DNS caching is enabled or disabled. Defaults to True.
- Dns
Resolver boolRotate - Enable or disable DNS resolver rotate. Defaults to False.
- Dns
Searches List<string> - List of DNS search suffixes.
- Dns
Servers List<string> - List of Domain Name Server IP addresses.
- Name string
- The name of the groupnet.
- Server
Side boolDns Search - Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
- Allow
Wildcard boolSubdomains - 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.
- Dns
Cache boolEnabled - DNS caching is enabled or disabled. Defaults to True.
- Dns
Resolver boolRotate - Enable or disable DNS resolver rotate. Defaults to False.
- Dns
Searches []string - List of DNS search suffixes.
- Dns
Servers []string - List of Domain Name Server IP addresses.
- Name string
- The name of the groupnet.
- Server
Side boolDns Search - Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
- allow
Wildcard BooleanSubdomains - 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.
- dns
Cache BooleanEnabled - DNS caching is enabled or disabled. Defaults to True.
- dns
Resolver BooleanRotate - Enable or disable DNS resolver rotate. Defaults to False.
- dns
Searches List<String> - List of DNS search suffixes.
- dns
Servers List<String> - List of Domain Name Server IP addresses.
- name String
- The name of the groupnet.
- server
Side BooleanDns Search - Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
- allow
Wildcard booleanSubdomains - 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.
- dns
Cache booleanEnabled - DNS caching is enabled or disabled. Defaults to True.
- dns
Resolver booleanRotate - Enable or disable DNS resolver rotate. Defaults to False.
- dns
Searches string[] - List of DNS search suffixes.
- dns
Servers string[] - List of Domain Name Server IP addresses.
- name string
- The name of the groupnet.
- server
Side booleanDns Search - Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
- allow_
wildcard_ boolsubdomains - 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_ boolenabled - DNS caching is enabled or disabled. Defaults to True.
- dns_
resolver_ boolrotate - 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_ booldns_ search - Enable or disable appending nodes DNS search list to client DNS inquiries directed at SmartConnect service IP. Defaults to True.
- allow
Wildcard BooleanSubdomains - 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.
- dns
Cache BooleanEnabled - DNS caching is enabled or disabled. Defaults to True.
- dns
Resolver BooleanRotate - Enable or disable DNS resolver rotate. Defaults to False.
- dns
Searches List<String> - List of DNS search suffixes.
- dns
Servers List<String> - List of Domain Name Server IP addresses.
- name String
- The name of the groupnet.
- server
Side BooleanDns Search - 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:
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.
- Allow
Wildcard boolSubdomains - 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.
- Dns
Cache boolEnabled - DNS caching is enabled or disabled. Defaults to True.
- Dns
Resolver boolRotate - Enable or disable DNS resolver rotate. Defaults to False.
- Dns
Searches List<string> - List of DNS search suffixes.
- Dns
Servers List<string> - List of Domain Name Server IP addresses.
- Name string
- The name of the groupnet.
- Server
Side boolDns Search - 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.
- Allow
Wildcard boolSubdomains - 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.
- Dns
Cache boolEnabled - DNS caching is enabled or disabled. Defaults to True.
- Dns
Resolver boolRotate - Enable or disable DNS resolver rotate. Defaults to False.
- Dns
Searches []string - List of DNS search suffixes.
- Dns
Servers []string - List of Domain Name Server IP addresses.
- Name string
- The name of the groupnet.
- Server
Side boolDns Search - 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 BooleanSubdomains - 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.
- dns
Cache BooleanEnabled - DNS caching is enabled or disabled. Defaults to True.
- dns
Resolver BooleanRotate - Enable or disable DNS resolver rotate. Defaults to False.
- dns
Searches List<String> - List of DNS search suffixes.
- dns
Servers List<String> - List of Domain Name Server IP addresses.
- name String
- The name of the groupnet.
- server
Side BooleanDns Search - 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.
- allow
Wildcard booleanSubdomains - 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.
- dns
Cache booleanEnabled - DNS caching is enabled or disabled. Defaults to True.
- dns
Resolver booleanRotate - Enable or disable DNS resolver rotate. Defaults to False.
- dns
Searches string[] - List of DNS search suffixes.
- dns
Servers string[] - List of Domain Name Server IP addresses.
- name string
- The name of the groupnet.
- server
Side booleanDns Search - 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_ boolsubdomains - 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_ boolenabled - DNS caching is enabled or disabled. Defaults to True.
- dns_
resolver_ boolrotate - 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_ booldns_ search - 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.
- allow
Wildcard BooleanSubdomains - 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.
- dns
Cache BooleanEnabled - DNS caching is enabled or disabled. Defaults to True.
- dns
Resolver BooleanRotate - Enable or disable DNS resolver rotate. Defaults to False.
- dns
Searches List<String> - List of DNS search suffixes.
- dns
Servers List<String> - List of Domain Name Server IP addresses.
- name String
- The name of the groupnet.
- server
Side BooleanDns Search - 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.