opentelekomcloud 1.36.37, Apr 24 25

opentelekomcloud 1.36.37 published on Thursday, Apr 24, 2025 by opentelekomcloud

opentelekomcloud/terraform-provider-opentelekomcloud

opentelekomcloud.VpcSubnetV1

Explore with Pulumi AI

opentelekomcloud 1.36.37 published on Thursday, Apr 24, 2025 by opentelekomcloud

opentelekomcloud/terraform-provider-opentelekomcloud

Example Usage

Basic Usage

import * as pulumi from "@pulumi/pulumi";
import * as opentelekomcloud from "@pulumi/opentelekomcloud";

const vpcV1 = new opentelekomcloud.VpcV1("vpcV1", {cidr: _var.vpc_cidr});
const subnetV1 = new opentelekomcloud.VpcSubnetV1("subnetV1", {
    cidr: _var.subnet_cidr,
    vpcId: vpcV1.vpcV1Id,
    gatewayIp: _var.subnet_gateway_ip,
    ntpAddresses: "10.100.0.33,10.100.0.34",
});

import pulumi
import pulumi_opentelekomcloud as opentelekomcloud

vpc_v1 = opentelekomcloud.VpcV1("vpcV1", cidr=var["vpc_cidr"])
subnet_v1 = opentelekomcloud.VpcSubnetV1("subnetV1",
    cidr=var["subnet_cidr"],
    vpc_id=vpc_v1.vpc_v1_id,
    gateway_ip=var["subnet_gateway_ip"],
    ntp_addresses="10.100.0.33,10.100.0.34")

package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/opentelekomcloud/opentelekomcloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		vpcV1, err := opentelekomcloud.NewVpcV1(ctx, "vpcV1", &opentelekomcloud.VpcV1Args{
			Cidr: pulumi.Any(_var.Vpc_cidr),
		})
		if err != nil {
			return err
		}
		_, err = opentelekomcloud.NewVpcSubnetV1(ctx, "subnetV1", &opentelekomcloud.VpcSubnetV1Args{
			Cidr:         pulumi.Any(_var.Subnet_cidr),
			VpcId:        vpcV1.VpcV1Id,
			GatewayIp:    pulumi.Any(_var.Subnet_gateway_ip),
			NtpAddresses: pulumi.String("10.100.0.33,10.100.0.34"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Opentelekomcloud = Pulumi.Opentelekomcloud;

return await Deployment.RunAsync(() => 
{
    var vpcV1 = new Opentelekomcloud.VpcV1("vpcV1", new()
    {
        Cidr = @var.Vpc_cidr,
    });

    var subnetV1 = new Opentelekomcloud.VpcSubnetV1("subnetV1", new()
    {
        Cidr = @var.Subnet_cidr,
        VpcId = vpcV1.VpcV1Id,
        GatewayIp = @var.Subnet_gateway_ip,
        NtpAddresses = "10.100.0.33,10.100.0.34",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.opentelekomcloud.VpcV1;
import com.pulumi.opentelekomcloud.VpcV1Args;
import com.pulumi.opentelekomcloud.VpcSubnetV1;
import com.pulumi.opentelekomcloud.VpcSubnetV1Args;
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) {
        var vpcV1 = new VpcV1("vpcV1", VpcV1Args.builder()
            .cidr(var_.vpc_cidr())
            .build());

        var subnetV1 = new VpcSubnetV1("subnetV1", VpcSubnetV1Args.builder()
            .cidr(var_.subnet_cidr())
            .vpcId(vpcV1.vpcV1Id())
            .gatewayIp(var_.subnet_gateway_ip())
            .ntpAddresses("10.100.0.33,10.100.0.34")
            .build());

    }
}

resources:
  vpcV1:
    type: opentelekomcloud:VpcV1
    properties:
      cidr: ${var.vpc_cidr}
  subnetV1:
    type: opentelekomcloud:VpcSubnetV1
    properties:
      cidr: ${var.subnet_cidr}
      vpcId: ${vpcV1.vpcV1Id}
      gatewayIp: ${var.subnet_gateway_ip}
      ntpAddresses: 10.100.0.33,10.100.0.34

Subnet with tags

import * as pulumi from "@pulumi/pulumi";
import * as opentelekomcloud from "@pulumi/opentelekomcloud";

const subnetWithTags = new opentelekomcloud.VpcSubnetV1("subnetWithTags", {
    cidr: _var.subnet_cidr,
    vpcId: opentelekomcloud_vpc_v1.vpc_v1.id,
    gatewayIp: _var.subnet_gateway_ip,
    ntpAddresses: "10.100.0.33,10.100.0.34",
    tags: {
        foo: "bar",
        key: "value",
    },
});

import pulumi
import pulumi_opentelekomcloud as opentelekomcloud

subnet_with_tags = opentelekomcloud.VpcSubnetV1("subnetWithTags",
    cidr=var["subnet_cidr"],
    vpc_id=opentelekomcloud_vpc_v1["vpc_v1"]["id"],
    gateway_ip=var["subnet_gateway_ip"],
    ntp_addresses="10.100.0.33,10.100.0.34",
    tags={
        "foo": "bar",
        "key": "value",
    })

package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/opentelekomcloud/opentelekomcloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := opentelekomcloud.NewVpcSubnetV1(ctx, "subnetWithTags", &opentelekomcloud.VpcSubnetV1Args{
			Cidr:         pulumi.Any(_var.Subnet_cidr),
			VpcId:        pulumi.Any(opentelekomcloud_vpc_v1.Vpc_v1.Id),
			GatewayIp:    pulumi.Any(_var.Subnet_gateway_ip),
			NtpAddresses: pulumi.String("10.100.0.33,10.100.0.34"),
			Tags: pulumi.StringMap{
				"foo": pulumi.String("bar"),
				"key": pulumi.String("value"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Opentelekomcloud = Pulumi.Opentelekomcloud;

return await Deployment.RunAsync(() => 
{
    var subnetWithTags = new Opentelekomcloud.VpcSubnetV1("subnetWithTags", new()
    {
        Cidr = @var.Subnet_cidr,
        VpcId = opentelekomcloud_vpc_v1.Vpc_v1.Id,
        GatewayIp = @var.Subnet_gateway_ip,
        NtpAddresses = "10.100.0.33,10.100.0.34",
        Tags = 
        {
            { "foo", "bar" },
            { "key", "value" },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.opentelekomcloud.VpcSubnetV1;
import com.pulumi.opentelekomcloud.VpcSubnetV1Args;
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) {
        var subnetWithTags = new VpcSubnetV1("subnetWithTags", VpcSubnetV1Args.builder()
            .cidr(var_.subnet_cidr())
            .vpcId(opentelekomcloud_vpc_v1.vpc_v1().id())
            .gatewayIp(var_.subnet_gateway_ip())
            .ntpAddresses("10.100.0.33,10.100.0.34")
            .tags(Map.ofEntries(
                Map.entry("foo", "bar"),
                Map.entry("key", "value")
            ))
            .build());

    }
}

resources:
  subnetWithTags:
    type: opentelekomcloud:VpcSubnetV1
    properties:
      cidr: ${var.subnet_cidr}
      vpcId: ${opentelekomcloud_vpc_v1.vpc_v1.id}
      gatewayIp: ${var.subnet_gateway_ip}
      ntpAddresses: 10.100.0.33,10.100.0.34
      tags:
        foo: bar
        key: value

Enable Ipv6

import * as pulumi from "@pulumi/pulumi";
import * as opentelekomcloud from "@pulumi/opentelekomcloud";

const subnetV6 = new opentelekomcloud.VpcSubnetV1("subnetV6", {
    description: "some description",
    cidr: "192.168.0.0/16",
    gatewayIp: "192.168.0.1",
    vpcId: opentelekomcloud_vpc_v1.vpc_1.id,
    availabilityZone: "eu-de-02",
    ntpAddresses: "10.100.0.33,10.100.0.34",
    ipv6Enable: true,
    tags: {
        foo: "bar",
        key: "value",
    },
});

import pulumi
import pulumi_opentelekomcloud as opentelekomcloud

subnet_v6 = opentelekomcloud.VpcSubnetV1("subnetV6",
    description="some description",
    cidr="192.168.0.0/16",
    gateway_ip="192.168.0.1",
    vpc_id=opentelekomcloud_vpc_v1["vpc_1"]["id"],
    availability_zone="eu-de-02",
    ntp_addresses="10.100.0.33,10.100.0.34",
    ipv6_enable=True,
    tags={
        "foo": "bar",
        "key": "value",
    })

package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/opentelekomcloud/opentelekomcloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := opentelekomcloud.NewVpcSubnetV1(ctx, "subnetV6", &opentelekomcloud.VpcSubnetV1Args{
			Description:      pulumi.String("some description"),
			Cidr:             pulumi.String("192.168.0.0/16"),
			GatewayIp:        pulumi.String("192.168.0.1"),
			VpcId:            pulumi.Any(opentelekomcloud_vpc_v1.Vpc_1.Id),
			AvailabilityZone: pulumi.String("eu-de-02"),
			NtpAddresses:     pulumi.String("10.100.0.33,10.100.0.34"),
			Ipv6Enable:       pulumi.Bool(true),
			Tags: pulumi.StringMap{
				"foo": pulumi.String("bar"),
				"key": pulumi.String("value"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Opentelekomcloud = Pulumi.Opentelekomcloud;

return await Deployment.RunAsync(() => 
{
    var subnetV6 = new Opentelekomcloud.VpcSubnetV1("subnetV6", new()
    {
        Description = "some description",
        Cidr = "192.168.0.0/16",
        GatewayIp = "192.168.0.1",
        VpcId = opentelekomcloud_vpc_v1.Vpc_1.Id,
        AvailabilityZone = "eu-de-02",
        NtpAddresses = "10.100.0.33,10.100.0.34",
        Ipv6Enable = true,
        Tags = 
        {
            { "foo", "bar" },
            { "key", "value" },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.opentelekomcloud.VpcSubnetV1;
import com.pulumi.opentelekomcloud.VpcSubnetV1Args;
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) {
        var subnetV6 = new VpcSubnetV1("subnetV6", VpcSubnetV1Args.builder()
            .description("some description")
            .cidr("192.168.0.0/16")
            .gatewayIp("192.168.0.1")
            .vpcId(opentelekomcloud_vpc_v1.vpc_1().id())
            .availabilityZone("eu-de-02")
            .ntpAddresses("10.100.0.33,10.100.0.34")
            .ipv6Enable(true)
            .tags(Map.ofEntries(
                Map.entry("foo", "bar"),
                Map.entry("key", "value")
            ))
            .build());

    }
}

resources:
  subnetV6:
    type: opentelekomcloud:VpcSubnetV1
    properties:
      description: some description
      cidr: 192.168.0.0/16
      gatewayIp: 192.168.0.1
      vpcId: ${opentelekomcloud_vpc_v1.vpc_1.id}
      availabilityZone: eu-de-02
      ntpAddresses: 10.100.0.33,10.100.0.34
      ipv6Enable: true
      tags:
        foo: bar
        key: value

Create VpcSubnetV1 Resource

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

Constructor syntax

new VpcSubnetV1(name: string, args: VpcSubnetV1Args, opts?: CustomResourceOptions);

@overload
def VpcSubnetV1(resource_name: str,
                args: VpcSubnetV1Args,
                opts: Optional[ResourceOptions] = None)

@overload
def VpcSubnetV1(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                gateway_ip: Optional[str] = None,
                cidr: Optional[str] = None,
                vpc_id: Optional[str] = None,
                ntp_addresses: Optional[str] = None,
                dns_lists: Optional[Sequence[str]] = None,
                dhcp_enable: Optional[bool] = None,
                ipv6_enable: Optional[bool] = None,
                name: Optional[str] = None,
                availability_zone: Optional[str] = None,
                primary_dns: Optional[str] = None,
                region: Optional[str] = None,
                secondary_dns: Optional[str] = None,
                tags: Optional[Mapping[str, str]] = None,
                timeouts: Optional[VpcSubnetV1TimeoutsArgs] = None,
                description: Optional[str] = None,
                vpc_subnet_v1_id: Optional[str] = None)

func NewVpcSubnetV1(ctx *Context, name string, args VpcSubnetV1Args, opts ...ResourceOption) (*VpcSubnetV1, error)

public VpcSubnetV1(string name, VpcSubnetV1Args args, CustomResourceOptions? opts = null)

public VpcSubnetV1(String name, VpcSubnetV1Args args)
public VpcSubnetV1(String name, VpcSubnetV1Args args, CustomResourceOptions options)

type: opentelekomcloud:VpcSubnetV1
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 VpcSubnetV1Args: 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 VpcSubnetV1Args: 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 VpcSubnetV1Args: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args VpcSubnetV1Args: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args VpcSubnetV1Args: 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 vpcSubnetV1Resource = new Opentelekomcloud.VpcSubnetV1("vpcSubnetV1Resource", new()
{
    GatewayIp = "string",
    Cidr = "string",
    VpcId = "string",
    NtpAddresses = "string",
    DnsLists = new[]
    {
        "string",
    },
    DhcpEnable = false,
    Ipv6Enable = false,
    Name = "string",
    AvailabilityZone = "string",
    PrimaryDns = "string",
    Region = "string",
    SecondaryDns = "string",
    Tags = 
    {
        { "string", "string" },
    },
    Timeouts = new Opentelekomcloud.Inputs.VpcSubnetV1TimeoutsArgs
    {
        Create = "string",
        Delete = "string",
    },
    Description = "string",
    VpcSubnetV1Id = "string",
});

example, err := opentelekomcloud.NewVpcSubnetV1(ctx, "vpcSubnetV1Resource", &opentelekomcloud.VpcSubnetV1Args{
	GatewayIp:    pulumi.String("string"),
	Cidr:         pulumi.String("string"),
	VpcId:        pulumi.String("string"),
	NtpAddresses: pulumi.String("string"),
	DnsLists: pulumi.StringArray{
		pulumi.String("string"),
	},
	DhcpEnable:       pulumi.Bool(false),
	Ipv6Enable:       pulumi.Bool(false),
	Name:             pulumi.String("string"),
	AvailabilityZone: pulumi.String("string"),
	PrimaryDns:       pulumi.String("string"),
	Region:           pulumi.String("string"),
	SecondaryDns:     pulumi.String("string"),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Timeouts: &opentelekomcloud.VpcSubnetV1TimeoutsArgs{
		Create: pulumi.String("string"),
		Delete: pulumi.String("string"),
	},
	Description:   pulumi.String("string"),
	VpcSubnetV1Id: pulumi.String("string"),
})

var vpcSubnetV1Resource = new VpcSubnetV1("vpcSubnetV1Resource", VpcSubnetV1Args.builder()
    .gatewayIp("string")
    .cidr("string")
    .vpcId("string")
    .ntpAddresses("string")
    .dnsLists("string")
    .dhcpEnable(false)
    .ipv6Enable(false)
    .name("string")
    .availabilityZone("string")
    .primaryDns("string")
    .region("string")
    .secondaryDns("string")
    .tags(Map.of("string", "string"))
    .timeouts(VpcSubnetV1TimeoutsArgs.builder()
        .create("string")
        .delete("string")
        .build())
    .description("string")
    .vpcSubnetV1Id("string")
    .build());

vpc_subnet_v1_resource = opentelekomcloud.VpcSubnetV1("vpcSubnetV1Resource",
    gateway_ip="string",
    cidr="string",
    vpc_id="string",
    ntp_addresses="string",
    dns_lists=["string"],
    dhcp_enable=False,
    ipv6_enable=False,
    name="string",
    availability_zone="string",
    primary_dns="string",
    region="string",
    secondary_dns="string",
    tags={
        "string": "string",
    },
    timeouts={
        "create": "string",
        "delete": "string",
    },
    description="string",
    vpc_subnet_v1_id="string")

const vpcSubnetV1Resource = new opentelekomcloud.VpcSubnetV1("vpcSubnetV1Resource", {
    gatewayIp: "string",
    cidr: "string",
    vpcId: "string",
    ntpAddresses: "string",
    dnsLists: ["string"],
    dhcpEnable: false,
    ipv6Enable: false,
    name: "string",
    availabilityZone: "string",
    primaryDns: "string",
    region: "string",
    secondaryDns: "string",
    tags: {
        string: "string",
    },
    timeouts: {
        create: "string",
        "delete": "string",
    },
    description: "string",
    vpcSubnetV1Id: "string",
});

type: opentelekomcloud:VpcSubnetV1
properties:
    availabilityZone: string
    cidr: string
    description: string
    dhcpEnable: false
    dnsLists:
        - string
    gatewayIp: string
    ipv6Enable: false
    name: string
    ntpAddresses: string
    primaryDns: string
    region: string
    secondaryDns: string
    tags:
        string: string
    timeouts:
        create: string
        delete: string
    vpcId: string
    vpcSubnetV1Id: string

VpcSubnetV1 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 VpcSubnetV1 resource accepts the following input properties:

Cidr string

Specifies the network segment on which the subnet resides. The value must be in CIDR format. The value must be within the CIDR block of the VPC. The subnet mask cannot be greater than 28. Changing this creates a new Subnet.

GatewayIp string

Specifies the gateway of the subnet. The value must be a valid IP address. The value must be an IP address in the subnet segment. Changing this creates a new Subnet.

VpcId string

Specifies the ID of the VPC to which the subnet belongs. Changing this creates a new Subnet.

AvailabilityZone string

Identifies the availability zone (AZ) to which the subnet belongs. The value must be an existing AZ in the system. Changing this creates a new Subnet.

Description string

A description of the VPC subnet.

DhcpEnable bool

Specifies whether the DHCP function is enabled for the subnet. The value can be true or false. If this parameter is left blank, it is set to true by default.

DnsLists List<string>

Specifies the DNS server address list of a subnet. This field is required if you need to use more than two DNS servers. This parameter value is the superset of both DNS server address 1 and DNS server address 2.

~> Please note that primary DNS should be set to OTC-internal for managed services (e.g. CCE, CSS) to work.

Ipv6Enable bool

Specifies whether IPv6 is enabled. If IPv6 is enabled, you can use IPv6 CIDR blocks. The value can be true or false. If this parameter is left blank, it is set to false by default.

Name string

The subnet name. The value is a string of 1 to 64 characters that can contain letters, digits, underscores (_), and hyphens (-).

NtpAddresses string

Specifies the NTP server address configured for the subnet.

PrimaryDns string

Specifies the IP address of DNS server 1 on the subnet. The value must be a valid IP address. Default is 100.125.4.25, OpenTelekomCloud internal DNS server.

Region string

SecondaryDns string

Specifies the IP address of DNS server 2 on the subnet. The value must be a valid IP address. Default is 100.125.129.199, OpenTelekomCloud secondary internal DNS server.

Tags Dictionary<string, string>

The key/value pairs to associate with the subnet.

Timeouts VpcSubnetV1Timeouts

VpcSubnetV1Id string

Specifies a resource ID in UUID format. Same as OpenStack network ID (OS_NETWORK_ID).

Cidr string

GatewayIp string

Specifies the gateway of the subnet. The value must be a valid IP address. The value must be an IP address in the subnet segment. Changing this creates a new Subnet.

VpcId string

Specifies the ID of the VPC to which the subnet belongs. Changing this creates a new Subnet.

AvailabilityZone string

Identifies the availability zone (AZ) to which the subnet belongs. The value must be an existing AZ in the system. Changing this creates a new Subnet.

Description string

A description of the VPC subnet.

DhcpEnable bool

Specifies whether the DHCP function is enabled for the subnet. The value can be true or false. If this parameter is left blank, it is set to true by default.

DnsLists []string

~> Please note that primary DNS should be set to OTC-internal for managed services (e.g. CCE, CSS) to work.

Ipv6Enable bool

Specifies whether IPv6 is enabled. If IPv6 is enabled, you can use IPv6 CIDR blocks. The value can be true or false. If this parameter is left blank, it is set to false by default.

Name string

The subnet name. The value is a string of 1 to 64 characters that can contain letters, digits, underscores (_), and hyphens (-).

NtpAddresses string

Specifies the NTP server address configured for the subnet.

PrimaryDns string

Specifies the IP address of DNS server 1 on the subnet. The value must be a valid IP address. Default is 100.125.4.25, OpenTelekomCloud internal DNS server.

Region string

SecondaryDns string

Specifies the IP address of DNS server 2 on the subnet. The value must be a valid IP address. Default is 100.125.129.199, OpenTelekomCloud secondary internal DNS server.

Tags map[string]string

The key/value pairs to associate with the subnet.

Timeouts VpcSubnetV1TimeoutsArgs

VpcSubnetV1Id string

Specifies a resource ID in UUID format. Same as OpenStack network ID (OS_NETWORK_ID).

cidr String

gatewayIp String

Specifies the gateway of the subnet. The value must be a valid IP address. The value must be an IP address in the subnet segment. Changing this creates a new Subnet.

vpcId String

Specifies the ID of the VPC to which the subnet belongs. Changing this creates a new Subnet.

availabilityZone String

Identifies the availability zone (AZ) to which the subnet belongs. The value must be an existing AZ in the system. Changing this creates a new Subnet.

description String

A description of the VPC subnet.

dhcpEnable Boolean

Specifies whether the DHCP function is enabled for the subnet. The value can be true or false. If this parameter is left blank, it is set to true by default.

dnsLists List<String>

~> Please note that primary DNS should be set to OTC-internal for managed services (e.g. CCE, CSS) to work.

ipv6Enable Boolean

Specifies whether IPv6 is enabled. If IPv6 is enabled, you can use IPv6 CIDR blocks. The value can be true or false. If this parameter is left blank, it is set to false by default.

name String

The subnet name. The value is a string of 1 to 64 characters that can contain letters, digits, underscores (_), and hyphens (-).

ntpAddresses String

Specifies the NTP server address configured for the subnet.

primaryDns String

Specifies the IP address of DNS server 1 on the subnet. The value must be a valid IP address. Default is 100.125.4.25, OpenTelekomCloud internal DNS server.

region String

secondaryDns String

Specifies the IP address of DNS server 2 on the subnet. The value must be a valid IP address. Default is 100.125.129.199, OpenTelekomCloud secondary internal DNS server.

tags Map<String,String>

The key/value pairs to associate with the subnet.

timeouts VpcSubnetV1Timeouts

vpcSubnetV1Id String

Specifies a resource ID in UUID format. Same as OpenStack network ID (OS_NETWORK_ID).

cidr string

gatewayIp string

Specifies the gateway of the subnet. The value must be a valid IP address. The value must be an IP address in the subnet segment. Changing this creates a new Subnet.

vpcId string

Specifies the ID of the VPC to which the subnet belongs. Changing this creates a new Subnet.

availabilityZone string

Identifies the availability zone (AZ) to which the subnet belongs. The value must be an existing AZ in the system. Changing this creates a new Subnet.

description string

A description of the VPC subnet.

dhcpEnable boolean

Specifies whether the DHCP function is enabled for the subnet. The value can be true or false. If this parameter is left blank, it is set to true by default.

dnsLists string[]

~> Please note that primary DNS should be set to OTC-internal for managed services (e.g. CCE, CSS) to work.

ipv6Enable boolean

Specifies whether IPv6 is enabled. If IPv6 is enabled, you can use IPv6 CIDR blocks. The value can be true or false. If this parameter is left blank, it is set to false by default.

name string

The subnet name. The value is a string of 1 to 64 characters that can contain letters, digits, underscores (_), and hyphens (-).

ntpAddresses string

Specifies the NTP server address configured for the subnet.

primaryDns string

Specifies the IP address of DNS server 1 on the subnet. The value must be a valid IP address. Default is 100.125.4.25, OpenTelekomCloud internal DNS server.

region string

secondaryDns string

Specifies the IP address of DNS server 2 on the subnet. The value must be a valid IP address. Default is 100.125.129.199, OpenTelekomCloud secondary internal DNS server.

tags {[key: string]: string}

The key/value pairs to associate with the subnet.

timeouts VpcSubnetV1Timeouts

vpcSubnetV1Id string

Specifies a resource ID in UUID format. Same as OpenStack network ID (OS_NETWORK_ID).

cidr str

gateway_ip str

Specifies the gateway of the subnet. The value must be a valid IP address. The value must be an IP address in the subnet segment. Changing this creates a new Subnet.

vpc_id str

Specifies the ID of the VPC to which the subnet belongs. Changing this creates a new Subnet.

availability_zone str

Identifies the availability zone (AZ) to which the subnet belongs. The value must be an existing AZ in the system. Changing this creates a new Subnet.

description str

A description of the VPC subnet.

dhcp_enable bool

Specifies whether the DHCP function is enabled for the subnet. The value can be true or false. If this parameter is left blank, it is set to true by default.

dns_lists Sequence[str]

~> Please note that primary DNS should be set to OTC-internal for managed services (e.g. CCE, CSS) to work.

ipv6_enable bool

Specifies whether IPv6 is enabled. If IPv6 is enabled, you can use IPv6 CIDR blocks. The value can be true or false. If this parameter is left blank, it is set to false by default.

name str

The subnet name. The value is a string of 1 to 64 characters that can contain letters, digits, underscores (_), and hyphens (-).

ntp_addresses str

Specifies the NTP server address configured for the subnet.

primary_dns str

Specifies the IP address of DNS server 1 on the subnet. The value must be a valid IP address. Default is 100.125.4.25, OpenTelekomCloud internal DNS server.

region str

secondary_dns str

Specifies the IP address of DNS server 2 on the subnet. The value must be a valid IP address. Default is 100.125.129.199, OpenTelekomCloud secondary internal DNS server.

tags Mapping[str, str]

The key/value pairs to associate with the subnet.

timeouts VpcSubnetV1TimeoutsArgs

vpc_subnet_v1_id str

Specifies a resource ID in UUID format. Same as OpenStack network ID (OS_NETWORK_ID).

cidr String

gatewayIp String

Specifies the gateway of the subnet. The value must be a valid IP address. The value must be an IP address in the subnet segment. Changing this creates a new Subnet.

vpcId String

Specifies the ID of the VPC to which the subnet belongs. Changing this creates a new Subnet.

availabilityZone String

Identifies the availability zone (AZ) to which the subnet belongs. The value must be an existing AZ in the system. Changing this creates a new Subnet.

description String

A description of the VPC subnet.

dhcpEnable Boolean

Specifies whether the DHCP function is enabled for the subnet. The value can be true or false. If this parameter is left blank, it is set to true by default.

dnsLists List<String>

~> Please note that primary DNS should be set to OTC-internal for managed services (e.g. CCE, CSS) to work.

ipv6Enable Boolean

Specifies whether IPv6 is enabled. If IPv6 is enabled, you can use IPv6 CIDR blocks. The value can be true or false. If this parameter is left blank, it is set to false by default.

name String

The subnet name. The value is a string of 1 to 64 characters that can contain letters, digits, underscores (_), and hyphens (-).

ntpAddresses String

Specifies the NTP server address configured for the subnet.

primaryDns String

Specifies the IP address of DNS server 1 on the subnet. The value must be a valid IP address. Default is 100.125.4.25, OpenTelekomCloud internal DNS server.

region String

secondaryDns String

Specifies the IP address of DNS server 2 on the subnet. The value must be a valid IP address. Default is 100.125.129.199, OpenTelekomCloud secondary internal DNS server.

tags Map<String>

The key/value pairs to associate with the subnet.

timeouts Property Map

vpcSubnetV1Id String

Specifies a resource ID in UUID format. Same as OpenStack network ID (OS_NETWORK_ID).

Outputs

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

CidrIpv6 string
GatewayIpv6 string
Id string: The provider-assigned unique ID for this managed resource.
NetworkId string: Specifies the OpenStack network ID.
Status string: Specifies the status of the subnet. The value can be ACTIVE, DOWN, UNKNOWN, or ERROR.
SubnetId string: Specifies the OpenStack subnet ID.

CidrIpv6 string
GatewayIpv6 string
Id string: The provider-assigned unique ID for this managed resource.
NetworkId string: Specifies the OpenStack network ID.
Status string: Specifies the status of the subnet. The value can be ACTIVE, DOWN, UNKNOWN, or ERROR.
SubnetId string: Specifies the OpenStack subnet ID.

cidrIpv6 String
gatewayIpv6 String
id String: The provider-assigned unique ID for this managed resource.
networkId String: Specifies the OpenStack network ID.
status String: Specifies the status of the subnet. The value can be ACTIVE, DOWN, UNKNOWN, or ERROR.
subnetId String: Specifies the OpenStack subnet ID.

cidrIpv6 string
gatewayIpv6 string
id string: The provider-assigned unique ID for this managed resource.
networkId string: Specifies the OpenStack network ID.
status string: Specifies the status of the subnet. The value can be ACTIVE, DOWN, UNKNOWN, or ERROR.
subnetId string: Specifies the OpenStack subnet ID.

cidr_ipv6 str
gateway_ipv6 str
id str: The provider-assigned unique ID for this managed resource.
network_id str: Specifies the OpenStack network ID.
status str: Specifies the status of the subnet. The value can be ACTIVE, DOWN, UNKNOWN, or ERROR.
subnet_id str: Specifies the OpenStack subnet ID.

cidrIpv6 String
gatewayIpv6 String
id String: The provider-assigned unique ID for this managed resource.
networkId String: Specifies the OpenStack network ID.
status String: Specifies the status of the subnet. The value can be ACTIVE, DOWN, UNKNOWN, or ERROR.
subnetId String: Specifies the OpenStack subnet ID.

Look up Existing VpcSubnetV1 Resource

Get an existing VpcSubnetV1 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?: VpcSubnetV1State, opts?: CustomResourceOptions): VpcSubnetV1

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        availability_zone: Optional[str] = None,
        cidr: Optional[str] = None,
        cidr_ipv6: Optional[str] = None,
        description: Optional[str] = None,
        dhcp_enable: Optional[bool] = None,
        dns_lists: Optional[Sequence[str]] = None,
        gateway_ip: Optional[str] = None,
        gateway_ipv6: Optional[str] = None,
        ipv6_enable: Optional[bool] = None,
        name: Optional[str] = None,
        network_id: Optional[str] = None,
        ntp_addresses: Optional[str] = None,
        primary_dns: Optional[str] = None,
        region: Optional[str] = None,
        secondary_dns: Optional[str] = None,
        status: Optional[str] = None,
        subnet_id: Optional[str] = None,
        tags: Optional[Mapping[str, str]] = None,
        timeouts: Optional[VpcSubnetV1TimeoutsArgs] = None,
        vpc_id: Optional[str] = None,
        vpc_subnet_v1_id: Optional[str] = None) -> VpcSubnetV1

func GetVpcSubnetV1(ctx *Context, name string, id IDInput, state *VpcSubnetV1State, opts ...ResourceOption) (*VpcSubnetV1, error)

public static VpcSubnetV1 Get(string name, Input<string> id, VpcSubnetV1State? state, CustomResourceOptions? opts = null)

public static VpcSubnetV1 get(String name, Output<String> id, VpcSubnetV1State state, CustomResourceOptions options)

resources:  _:    type: opentelekomcloud:VpcSubnetV1    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:

AvailabilityZone string

Identifies the availability zone (AZ) to which the subnet belongs. The value must be an existing AZ in the system. Changing this creates a new Subnet.

Cidr string

CidrIpv6 string

Description string

A description of the VPC subnet.

DhcpEnable bool

Specifies whether the DHCP function is enabled for the subnet. The value can be true or false. If this parameter is left blank, it is set to true by default.

DnsLists List<string>

~> Please note that primary DNS should be set to OTC-internal for managed services (e.g. CCE, CSS) to work.

GatewayIp string

Specifies the gateway of the subnet. The value must be a valid IP address. The value must be an IP address in the subnet segment. Changing this creates a new Subnet.

GatewayIpv6 string

Ipv6Enable bool

Specifies whether IPv6 is enabled. If IPv6 is enabled, you can use IPv6 CIDR blocks. The value can be true or false. If this parameter is left blank, it is set to false by default.

Name string

The subnet name. The value is a string of 1 to 64 characters that can contain letters, digits, underscores (_), and hyphens (-).

NetworkId string

Specifies the OpenStack network ID.

NtpAddresses string

Specifies the NTP server address configured for the subnet.

PrimaryDns string

Specifies the IP address of DNS server 1 on the subnet. The value must be a valid IP address. Default is 100.125.4.25, OpenTelekomCloud internal DNS server.

Region string

SecondaryDns string

Specifies the IP address of DNS server 2 on the subnet. The value must be a valid IP address. Default is 100.125.129.199, OpenTelekomCloud secondary internal DNS server.

Status string

Specifies the status of the subnet. The value can be ACTIVE, DOWN, UNKNOWN, or ERROR.

SubnetId string

Specifies the OpenStack subnet ID.

Tags Dictionary<string, string>

The key/value pairs to associate with the subnet.

Timeouts VpcSubnetV1Timeouts

VpcId string

Specifies the ID of the VPC to which the subnet belongs. Changing this creates a new Subnet.

VpcSubnetV1Id string

Specifies a resource ID in UUID format. Same as OpenStack network ID (OS_NETWORK_ID).

AvailabilityZone string

Identifies the availability zone (AZ) to which the subnet belongs. The value must be an existing AZ in the system. Changing this creates a new Subnet.

Cidr string

CidrIpv6 string

Description string

A description of the VPC subnet.

DhcpEnable bool

Specifies whether the DHCP function is enabled for the subnet. The value can be true or false. If this parameter is left blank, it is set to true by default.

DnsLists []string

~> Please note that primary DNS should be set to OTC-internal for managed services (e.g. CCE, CSS) to work.

GatewayIp string

Specifies the gateway of the subnet. The value must be a valid IP address. The value must be an IP address in the subnet segment. Changing this creates a new Subnet.

GatewayIpv6 string

Ipv6Enable bool

Specifies whether IPv6 is enabled. If IPv6 is enabled, you can use IPv6 CIDR blocks. The value can be true or false. If this parameter is left blank, it is set to false by default.

Name string

The subnet name. The value is a string of 1 to 64 characters that can contain letters, digits, underscores (_), and hyphens (-).

NetworkId string

Specifies the OpenStack network ID.

NtpAddresses string

Specifies the NTP server address configured for the subnet.

PrimaryDns string

Specifies the IP address of DNS server 1 on the subnet. The value must be a valid IP address. Default is 100.125.4.25, OpenTelekomCloud internal DNS server.

Region string

SecondaryDns string

Specifies the IP address of DNS server 2 on the subnet. The value must be a valid IP address. Default is 100.125.129.199, OpenTelekomCloud secondary internal DNS server.

Status string

Specifies the status of the subnet. The value can be ACTIVE, DOWN, UNKNOWN, or ERROR.

SubnetId string

Specifies the OpenStack subnet ID.

Tags map[string]string

The key/value pairs to associate with the subnet.

Timeouts VpcSubnetV1TimeoutsArgs

VpcId string

Specifies the ID of the VPC to which the subnet belongs. Changing this creates a new Subnet.

VpcSubnetV1Id string

Specifies a resource ID in UUID format. Same as OpenStack network ID (OS_NETWORK_ID).

availabilityZone String

Identifies the availability zone (AZ) to which the subnet belongs. The value must be an existing AZ in the system. Changing this creates a new Subnet.

cidr String

cidrIpv6 String

description String

A description of the VPC subnet.

dhcpEnable Boolean

Specifies whether the DHCP function is enabled for the subnet. The value can be true or false. If this parameter is left blank, it is set to true by default.

dnsLists List<String>

~> Please note that primary DNS should be set to OTC-internal for managed services (e.g. CCE, CSS) to work.

gatewayIp String

Specifies the gateway of the subnet. The value must be a valid IP address. The value must be an IP address in the subnet segment. Changing this creates a new Subnet.

gatewayIpv6 String

ipv6Enable Boolean

Specifies whether IPv6 is enabled. If IPv6 is enabled, you can use IPv6 CIDR blocks. The value can be true or false. If this parameter is left blank, it is set to false by default.

name String

The subnet name. The value is a string of 1 to 64 characters that can contain letters, digits, underscores (_), and hyphens (-).

networkId String

Specifies the OpenStack network ID.

ntpAddresses String

Specifies the NTP server address configured for the subnet.

primaryDns String

Specifies the IP address of DNS server 1 on the subnet. The value must be a valid IP address. Default is 100.125.4.25, OpenTelekomCloud internal DNS server.

region String

secondaryDns String

Specifies the IP address of DNS server 2 on the subnet. The value must be a valid IP address. Default is 100.125.129.199, OpenTelekomCloud secondary internal DNS server.

status String

Specifies the status of the subnet. The value can be ACTIVE, DOWN, UNKNOWN, or ERROR.

subnetId String

Specifies the OpenStack subnet ID.

tags Map<String,String>

The key/value pairs to associate with the subnet.

timeouts VpcSubnetV1Timeouts

vpcId String

Specifies the ID of the VPC to which the subnet belongs. Changing this creates a new Subnet.

vpcSubnetV1Id String

Specifies a resource ID in UUID format. Same as OpenStack network ID (OS_NETWORK_ID).

availabilityZone string

Identifies the availability zone (AZ) to which the subnet belongs. The value must be an existing AZ in the system. Changing this creates a new Subnet.

cidr string

cidrIpv6 string

description string

A description of the VPC subnet.

dhcpEnable boolean

Specifies whether the DHCP function is enabled for the subnet. The value can be true or false. If this parameter is left blank, it is set to true by default.

dnsLists string[]

~> Please note that primary DNS should be set to OTC-internal for managed services (e.g. CCE, CSS) to work.

gatewayIp string

Specifies the gateway of the subnet. The value must be a valid IP address. The value must be an IP address in the subnet segment. Changing this creates a new Subnet.

gatewayIpv6 string

ipv6Enable boolean

Specifies whether IPv6 is enabled. If IPv6 is enabled, you can use IPv6 CIDR blocks. The value can be true or false. If this parameter is left blank, it is set to false by default.

name string

The subnet name. The value is a string of 1 to 64 characters that can contain letters, digits, underscores (_), and hyphens (-).

networkId string

Specifies the OpenStack network ID.

ntpAddresses string

Specifies the NTP server address configured for the subnet.

primaryDns string

Specifies the IP address of DNS server 1 on the subnet. The value must be a valid IP address. Default is 100.125.4.25, OpenTelekomCloud internal DNS server.

region string

secondaryDns string

Specifies the IP address of DNS server 2 on the subnet. The value must be a valid IP address. Default is 100.125.129.199, OpenTelekomCloud secondary internal DNS server.

status string

Specifies the status of the subnet. The value can be ACTIVE, DOWN, UNKNOWN, or ERROR.

subnetId string

Specifies the OpenStack subnet ID.

tags {[key: string]: string}

The key/value pairs to associate with the subnet.

timeouts VpcSubnetV1Timeouts

vpcId string

Specifies the ID of the VPC to which the subnet belongs. Changing this creates a new Subnet.

vpcSubnetV1Id string

Specifies a resource ID in UUID format. Same as OpenStack network ID (OS_NETWORK_ID).

availability_zone str

Identifies the availability zone (AZ) to which the subnet belongs. The value must be an existing AZ in the system. Changing this creates a new Subnet.

cidr str

cidr_ipv6 str

description str

A description of the VPC subnet.

dhcp_enable bool

Specifies whether the DHCP function is enabled for the subnet. The value can be true or false. If this parameter is left blank, it is set to true by default.

dns_lists Sequence[str]

~> Please note that primary DNS should be set to OTC-internal for managed services (e.g. CCE, CSS) to work.

gateway_ip str

Specifies the gateway of the subnet. The value must be a valid IP address. The value must be an IP address in the subnet segment. Changing this creates a new Subnet.

gateway_ipv6 str

ipv6_enable bool

Specifies whether IPv6 is enabled. If IPv6 is enabled, you can use IPv6 CIDR blocks. The value can be true or false. If this parameter is left blank, it is set to false by default.

name str

The subnet name. The value is a string of 1 to 64 characters that can contain letters, digits, underscores (_), and hyphens (-).

network_id str

Specifies the OpenStack network ID.

ntp_addresses str

Specifies the NTP server address configured for the subnet.

primary_dns str

Specifies the IP address of DNS server 1 on the subnet. The value must be a valid IP address. Default is 100.125.4.25, OpenTelekomCloud internal DNS server.

region str

secondary_dns str

Specifies the IP address of DNS server 2 on the subnet. The value must be a valid IP address. Default is 100.125.129.199, OpenTelekomCloud secondary internal DNS server.

status str

Specifies the status of the subnet. The value can be ACTIVE, DOWN, UNKNOWN, or ERROR.

subnet_id str

Specifies the OpenStack subnet ID.

tags Mapping[str, str]

The key/value pairs to associate with the subnet.

timeouts VpcSubnetV1TimeoutsArgs

vpc_id str

Specifies the ID of the VPC to which the subnet belongs. Changing this creates a new Subnet.

vpc_subnet_v1_id str

Specifies a resource ID in UUID format. Same as OpenStack network ID (OS_NETWORK_ID).

availabilityZone String

Identifies the availability zone (AZ) to which the subnet belongs. The value must be an existing AZ in the system. Changing this creates a new Subnet.

cidr String

cidrIpv6 String

description String

A description of the VPC subnet.

dhcpEnable Boolean

Specifies whether the DHCP function is enabled for the subnet. The value can be true or false. If this parameter is left blank, it is set to true by default.

dnsLists List<String>

~> Please note that primary DNS should be set to OTC-internal for managed services (e.g. CCE, CSS) to work.

gatewayIp String

Specifies the gateway of the subnet. The value must be a valid IP address. The value must be an IP address in the subnet segment. Changing this creates a new Subnet.

gatewayIpv6 String

ipv6Enable Boolean

Specifies whether IPv6 is enabled. If IPv6 is enabled, you can use IPv6 CIDR blocks. The value can be true or false. If this parameter is left blank, it is set to false by default.

name String

The subnet name. The value is a string of 1 to 64 characters that can contain letters, digits, underscores (_), and hyphens (-).

networkId String

Specifies the OpenStack network ID.

ntpAddresses String

Specifies the NTP server address configured for the subnet.

primaryDns String

Specifies the IP address of DNS server 1 on the subnet. The value must be a valid IP address. Default is 100.125.4.25, OpenTelekomCloud internal DNS server.

region String

secondaryDns String

Specifies the IP address of DNS server 2 on the subnet. The value must be a valid IP address. Default is 100.125.129.199, OpenTelekomCloud secondary internal DNS server.

status String

Specifies the status of the subnet. The value can be ACTIVE, DOWN, UNKNOWN, or ERROR.

subnetId String

Specifies the OpenStack subnet ID.

tags Map<String>

The key/value pairs to associate with the subnet.

timeouts Property Map

vpcId String

Specifies the ID of the VPC to which the subnet belongs. Changing this creates a new Subnet.

vpcSubnetV1Id String

Specifies a resource ID in UUID format. Same as OpenStack network ID (OS_NETWORK_ID).

Supporting Types

VpcSubnetV1Timeouts, VpcSubnetV1TimeoutsArgs

Create string
Delete string

Create string
Delete string

create String
delete String

create string
delete string

create str
delete str

create String
delete String

Import

Subnets can be imported using the subnet id, e.g.

$ pulumi import opentelekomcloud:index/vpcSubnetV1:VpcSubnetV1 subnet_v1 4779ab1c-7c1a-44b1-a02e-93dfc361b32d

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

Package Details

Repository: opentelekomcloud opentelekomcloud/terraform-provider-opentelekomcloud
License
Notes: This Pulumi package is based on the opentelekomcloud Terraform Provider.

opentelekomcloud 1.36.37 published on Thursday, Apr 24, 2025 by opentelekomcloud

opentelekomcloud/terraform-provider-opentelekomcloud

opentelekomcloud.VpcSubnetV1

On this page

On this page

Example Usage

Basic Usage

Subnet with tags

Enable Ipv6

Create VpcSubnetV1 Resource

Constructor syntax

Parameters

Constructor example

VpcSubnetV1 Resource Properties

Inputs

Outputs

Look up Existing VpcSubnetV1 Resource

Supporting Types

VpcSubnetV1Timeouts, VpcSubnetV1TimeoutsArgs

Import

Package Details

On this page

On this page