opentelekomcloud.DcVirtualGatewayV3
Explore with Pulumi AI
Manages a virtual gateway v3 resource within OpenTelekomCloud.
NOTE: Direct Connect v3 API that are used in this resource officially supported only on SwissCloud now.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as opentelekomcloud from "@pulumi/opentelekomcloud";
const config = new pulumi.Config();
const vpcId = config.requireObject("vpcId");
const vpcCidr = config.requireObject("vpcCidr");
const gatewayName = config.requireObject("gatewayName");
const gw = new opentelekomcloud.DcVirtualGatewayV3("gw", {
vpcId: vpcId,
description: "my gateway",
localEpGroups: [vpcCidr],
});
import pulumi
import pulumi_opentelekomcloud as opentelekomcloud
config = pulumi.Config()
vpc_id = config.require_object("vpcId")
vpc_cidr = config.require_object("vpcCidr")
gateway_name = config.require_object("gatewayName")
gw = opentelekomcloud.DcVirtualGatewayV3("gw",
vpc_id=vpc_id,
description="my gateway",
local_ep_groups=[vpc_cidr])
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/opentelekomcloud/opentelekomcloud"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
cfg := config.New(ctx, "")
vpcId := cfg.RequireObject("vpcId")
vpcCidr := cfg.RequireObject("vpcCidr")
gatewayName := cfg.RequireObject("gatewayName")
_, err := opentelekomcloud.NewDcVirtualGatewayV3(ctx, "gw", &opentelekomcloud.DcVirtualGatewayV3Args{
VpcId: pulumi.Any(vpcId),
Description: pulumi.String("my gateway"),
LocalEpGroups: pulumi.StringArray{
vpcCidr,
},
})
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 config = new Config();
var vpcId = config.RequireObject<dynamic>("vpcId");
var vpcCidr = config.RequireObject<dynamic>("vpcCidr");
var gatewayName = config.RequireObject<dynamic>("gatewayName");
var gw = new Opentelekomcloud.DcVirtualGatewayV3("gw", new()
{
VpcId = vpcId,
Description = "my gateway",
LocalEpGroups = new[]
{
vpcCidr,
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.opentelekomcloud.DcVirtualGatewayV3;
import com.pulumi.opentelekomcloud.DcVirtualGatewayV3Args;
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) {
final var config = ctx.config();
final var vpcId = config.get("vpcId");
final var vpcCidr = config.get("vpcCidr");
final var gatewayName = config.get("gatewayName");
var gw = new DcVirtualGatewayV3("gw", DcVirtualGatewayV3Args.builder()
.vpcId(vpcId)
.description("my gateway")
.localEpGroups(vpcCidr)
.build());
}
}
configuration:
vpcId:
type: dynamic
vpcCidr:
type: dynamic
gatewayName:
type: dynamic
resources:
gw:
type: opentelekomcloud:DcVirtualGatewayV3
properties:
vpcId: ${vpcId}
description: my gateway
localEpGroups:
- ${vpcCidr}
Create DcVirtualGatewayV3 Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new DcVirtualGatewayV3(name: string, args: DcVirtualGatewayV3Args, opts?: CustomResourceOptions);
@overload
def DcVirtualGatewayV3(resource_name: str,
args: DcVirtualGatewayV3Args,
opts: Optional[ResourceOptions] = None)
@overload
def DcVirtualGatewayV3(resource_name: str,
opts: Optional[ResourceOptions] = None,
local_ep_groups: Optional[Sequence[str]] = None,
vpc_id: Optional[str] = None,
asn: Optional[float] = None,
dc_virtual_gateway_v3_id: Optional[str] = None,
description: Optional[str] = None,
local_ep_group_ipv6s: Optional[Sequence[str]] = None,
name: Optional[str] = None)
func NewDcVirtualGatewayV3(ctx *Context, name string, args DcVirtualGatewayV3Args, opts ...ResourceOption) (*DcVirtualGatewayV3, error)
public DcVirtualGatewayV3(string name, DcVirtualGatewayV3Args args, CustomResourceOptions? opts = null)
public DcVirtualGatewayV3(String name, DcVirtualGatewayV3Args args)
public DcVirtualGatewayV3(String name, DcVirtualGatewayV3Args args, CustomResourceOptions options)
type: opentelekomcloud:DcVirtualGatewayV3
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 DcVirtualGatewayV3Args
- 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 DcVirtualGatewayV3Args
- 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 DcVirtualGatewayV3Args
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args DcVirtualGatewayV3Args
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args DcVirtualGatewayV3Args
- 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 dcVirtualGatewayV3Resource = new Opentelekomcloud.DcVirtualGatewayV3("dcVirtualGatewayV3Resource", new()
{
LocalEpGroups = new[]
{
"string",
},
VpcId = "string",
Asn = 0,
DcVirtualGatewayV3Id = "string",
Description = "string",
LocalEpGroupIpv6s = new[]
{
"string",
},
Name = "string",
});
example, err := opentelekomcloud.NewDcVirtualGatewayV3(ctx, "dcVirtualGatewayV3Resource", &opentelekomcloud.DcVirtualGatewayV3Args{
LocalEpGroups: pulumi.StringArray{
pulumi.String("string"),
},
VpcId: pulumi.String("string"),
Asn: pulumi.Float64(0),
DcVirtualGatewayV3Id: pulumi.String("string"),
Description: pulumi.String("string"),
LocalEpGroupIpv6s: pulumi.StringArray{
pulumi.String("string"),
},
Name: pulumi.String("string"),
})
var dcVirtualGatewayV3Resource = new DcVirtualGatewayV3("dcVirtualGatewayV3Resource", DcVirtualGatewayV3Args.builder()
.localEpGroups("string")
.vpcId("string")
.asn(0)
.dcVirtualGatewayV3Id("string")
.description("string")
.localEpGroupIpv6s("string")
.name("string")
.build());
dc_virtual_gateway_v3_resource = opentelekomcloud.DcVirtualGatewayV3("dcVirtualGatewayV3Resource",
local_ep_groups=["string"],
vpc_id="string",
asn=0,
dc_virtual_gateway_v3_id="string",
description="string",
local_ep_group_ipv6s=["string"],
name="string")
const dcVirtualGatewayV3Resource = new opentelekomcloud.DcVirtualGatewayV3("dcVirtualGatewayV3Resource", {
localEpGroups: ["string"],
vpcId: "string",
asn: 0,
dcVirtualGatewayV3Id: "string",
description: "string",
localEpGroupIpv6s: ["string"],
name: "string",
});
type: opentelekomcloud:DcVirtualGatewayV3
properties:
asn: 0
dcVirtualGatewayV3Id: string
description: string
localEpGroupIpv6s:
- string
localEpGroups:
- string
name: string
vpcId: string
DcVirtualGatewayV3 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 DcVirtualGatewayV3 resource accepts the following input properties:
- Local
Ep List<string>Groups - Specifies the list of IPv4 subnets from the virtual gateway to access cloud services, which is usually the CIDR block of the VPC.
- Vpc
Id string - Specifies the ID of the VPC connected to the virtual gateway. Changing this will create a new resource.
- Asn double
- Specifies the local BGP ASN of the virtual gateway.
The valid value is range from
1
to4,294,967,295
. Changing this will create a new resource. - Dc
Virtual stringGateway V3Id - The ID of the virtual gateway.
- Description string
- Specifies the description of the virtual gateway.
The description contain a maximum of 128 characters and the angle brackets (< and >) are not allowed.
Chinese characters must be in
UTF-8
orUnicode
format. - Local
Ep List<string>Group Ipv6s - Specifies the IPv6 subnets of the associated VPC that can be accessed over the virtual gateway.
- Name string
- Specifies the name of the virtual gateway.
The valid length is limited from
3
to64
, only chinese and english letters, digits, hyphens (-), underscores (_) and dots (.) are allowed. The Chinese characters must be inUTF-8
orUnicode
format.
- Local
Ep []stringGroups - Specifies the list of IPv4 subnets from the virtual gateway to access cloud services, which is usually the CIDR block of the VPC.
- Vpc
Id string - Specifies the ID of the VPC connected to the virtual gateway. Changing this will create a new resource.
- Asn float64
- Specifies the local BGP ASN of the virtual gateway.
The valid value is range from
1
to4,294,967,295
. Changing this will create a new resource. - Dc
Virtual stringGateway V3Id - The ID of the virtual gateway.
- Description string
- Specifies the description of the virtual gateway.
The description contain a maximum of 128 characters and the angle brackets (< and >) are not allowed.
Chinese characters must be in
UTF-8
orUnicode
format. - Local
Ep []stringGroup Ipv6s - Specifies the IPv6 subnets of the associated VPC that can be accessed over the virtual gateway.
- Name string
- Specifies the name of the virtual gateway.
The valid length is limited from
3
to64
, only chinese and english letters, digits, hyphens (-), underscores (_) and dots (.) are allowed. The Chinese characters must be inUTF-8
orUnicode
format.
- local
Ep List<String>Groups - Specifies the list of IPv4 subnets from the virtual gateway to access cloud services, which is usually the CIDR block of the VPC.
- vpc
Id String - Specifies the ID of the VPC connected to the virtual gateway. Changing this will create a new resource.
- asn Double
- Specifies the local BGP ASN of the virtual gateway.
The valid value is range from
1
to4,294,967,295
. Changing this will create a new resource. - dc
Virtual StringGateway V3Id - The ID of the virtual gateway.
- description String
- Specifies the description of the virtual gateway.
The description contain a maximum of 128 characters and the angle brackets (< and >) are not allowed.
Chinese characters must be in
UTF-8
orUnicode
format. - local
Ep List<String>Group Ipv6s - Specifies the IPv6 subnets of the associated VPC that can be accessed over the virtual gateway.
- name String
- Specifies the name of the virtual gateway.
The valid length is limited from
3
to64
, only chinese and english letters, digits, hyphens (-), underscores (_) and dots (.) are allowed. The Chinese characters must be inUTF-8
orUnicode
format.
- local
Ep string[]Groups - Specifies the list of IPv4 subnets from the virtual gateway to access cloud services, which is usually the CIDR block of the VPC.
- vpc
Id string - Specifies the ID of the VPC connected to the virtual gateway. Changing this will create a new resource.
- asn number
- Specifies the local BGP ASN of the virtual gateway.
The valid value is range from
1
to4,294,967,295
. Changing this will create a new resource. - dc
Virtual stringGateway V3Id - The ID of the virtual gateway.
- description string
- Specifies the description of the virtual gateway.
The description contain a maximum of 128 characters and the angle brackets (< and >) are not allowed.
Chinese characters must be in
UTF-8
orUnicode
format. - local
Ep string[]Group Ipv6s - Specifies the IPv6 subnets of the associated VPC that can be accessed over the virtual gateway.
- name string
- Specifies the name of the virtual gateway.
The valid length is limited from
3
to64
, only chinese and english letters, digits, hyphens (-), underscores (_) and dots (.) are allowed. The Chinese characters must be inUTF-8
orUnicode
format.
- local_
ep_ Sequence[str]groups - Specifies the list of IPv4 subnets from the virtual gateway to access cloud services, which is usually the CIDR block of the VPC.
- vpc_
id str - Specifies the ID of the VPC connected to the virtual gateway. Changing this will create a new resource.
- asn float
- Specifies the local BGP ASN of the virtual gateway.
The valid value is range from
1
to4,294,967,295
. Changing this will create a new resource. - dc_
virtual_ strgateway_ v3_ id - The ID of the virtual gateway.
- description str
- Specifies the description of the virtual gateway.
The description contain a maximum of 128 characters and the angle brackets (< and >) are not allowed.
Chinese characters must be in
UTF-8
orUnicode
format. - local_
ep_ Sequence[str]group_ ipv6s - Specifies the IPv6 subnets of the associated VPC that can be accessed over the virtual gateway.
- name str
- Specifies the name of the virtual gateway.
The valid length is limited from
3
to64
, only chinese and english letters, digits, hyphens (-), underscores (_) and dots (.) are allowed. The Chinese characters must be inUTF-8
orUnicode
format.
- local
Ep List<String>Groups - Specifies the list of IPv4 subnets from the virtual gateway to access cloud services, which is usually the CIDR block of the VPC.
- vpc
Id String - Specifies the ID of the VPC connected to the virtual gateway. Changing this will create a new resource.
- asn Number
- Specifies the local BGP ASN of the virtual gateway.
The valid value is range from
1
to4,294,967,295
. Changing this will create a new resource. - dc
Virtual StringGateway V3Id - The ID of the virtual gateway.
- description String
- Specifies the description of the virtual gateway.
The description contain a maximum of 128 characters and the angle brackets (< and >) are not allowed.
Chinese characters must be in
UTF-8
orUnicode
format. - local
Ep List<String>Group Ipv6s - Specifies the IPv6 subnets of the associated VPC that can be accessed over the virtual gateway.
- name String
- Specifies the name of the virtual gateway.
The valid length is limited from
3
to64
, only chinese and english letters, digits, hyphens (-), underscores (_) and dots (.) are allowed. The Chinese characters must be inUTF-8
orUnicode
format.
Outputs
All input properties are implicitly available as output properties. Additionally, the DcVirtualGatewayV3 resource produces the following output properties:
Look up Existing DcVirtualGatewayV3 Resource
Get an existing DcVirtualGatewayV3 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?: DcVirtualGatewayV3State, opts?: CustomResourceOptions): DcVirtualGatewayV3
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
asn: Optional[float] = None,
dc_virtual_gateway_v3_id: Optional[str] = None,
description: Optional[str] = None,
local_ep_group_ipv6s: Optional[Sequence[str]] = None,
local_ep_groups: Optional[Sequence[str]] = None,
name: Optional[str] = None,
region: Optional[str] = None,
status: Optional[str] = None,
vpc_id: Optional[str] = None) -> DcVirtualGatewayV3
func GetDcVirtualGatewayV3(ctx *Context, name string, id IDInput, state *DcVirtualGatewayV3State, opts ...ResourceOption) (*DcVirtualGatewayV3, error)
public static DcVirtualGatewayV3 Get(string name, Input<string> id, DcVirtualGatewayV3State? state, CustomResourceOptions? opts = null)
public static DcVirtualGatewayV3 get(String name, Output<String> id, DcVirtualGatewayV3State state, CustomResourceOptions options)
resources: _: type: opentelekomcloud:DcVirtualGatewayV3 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.
- Asn double
- Specifies the local BGP ASN of the virtual gateway.
The valid value is range from
1
to4,294,967,295
. Changing this will create a new resource. - Dc
Virtual stringGateway V3Id - The ID of the virtual gateway.
- Description string
- Specifies the description of the virtual gateway.
The description contain a maximum of 128 characters and the angle brackets (< and >) are not allowed.
Chinese characters must be in
UTF-8
orUnicode
format. - Local
Ep List<string>Group Ipv6s - Specifies the IPv6 subnets of the associated VPC that can be accessed over the virtual gateway.
- Local
Ep List<string>Groups - Specifies the list of IPv4 subnets from the virtual gateway to access cloud services, which is usually the CIDR block of the VPC.
- Name string
- Specifies the name of the virtual gateway.
The valid length is limited from
3
to64
, only chinese and english letters, digits, hyphens (-), underscores (_) and dots (.) are allowed. The Chinese characters must be inUTF-8
orUnicode
format. - Region string
- The region where the virtual gateway is located.
- Status string
- The current status of the virtual gateway.
- Vpc
Id string - Specifies the ID of the VPC connected to the virtual gateway. Changing this will create a new resource.
- Asn float64
- Specifies the local BGP ASN of the virtual gateway.
The valid value is range from
1
to4,294,967,295
. Changing this will create a new resource. - Dc
Virtual stringGateway V3Id - The ID of the virtual gateway.
- Description string
- Specifies the description of the virtual gateway.
The description contain a maximum of 128 characters and the angle brackets (< and >) are not allowed.
Chinese characters must be in
UTF-8
orUnicode
format. - Local
Ep []stringGroup Ipv6s - Specifies the IPv6 subnets of the associated VPC that can be accessed over the virtual gateway.
- Local
Ep []stringGroups - Specifies the list of IPv4 subnets from the virtual gateway to access cloud services, which is usually the CIDR block of the VPC.
- Name string
- Specifies the name of the virtual gateway.
The valid length is limited from
3
to64
, only chinese and english letters, digits, hyphens (-), underscores (_) and dots (.) are allowed. The Chinese characters must be inUTF-8
orUnicode
format. - Region string
- The region where the virtual gateway is located.
- Status string
- The current status of the virtual gateway.
- Vpc
Id string - Specifies the ID of the VPC connected to the virtual gateway. Changing this will create a new resource.
- asn Double
- Specifies the local BGP ASN of the virtual gateway.
The valid value is range from
1
to4,294,967,295
. Changing this will create a new resource. - dc
Virtual StringGateway V3Id - The ID of the virtual gateway.
- description String
- Specifies the description of the virtual gateway.
The description contain a maximum of 128 characters and the angle brackets (< and >) are not allowed.
Chinese characters must be in
UTF-8
orUnicode
format. - local
Ep List<String>Group Ipv6s - Specifies the IPv6 subnets of the associated VPC that can be accessed over the virtual gateway.
- local
Ep List<String>Groups - Specifies the list of IPv4 subnets from the virtual gateway to access cloud services, which is usually the CIDR block of the VPC.
- name String
- Specifies the name of the virtual gateway.
The valid length is limited from
3
to64
, only chinese and english letters, digits, hyphens (-), underscores (_) and dots (.) are allowed. The Chinese characters must be inUTF-8
orUnicode
format. - region String
- The region where the virtual gateway is located.
- status String
- The current status of the virtual gateway.
- vpc
Id String - Specifies the ID of the VPC connected to the virtual gateway. Changing this will create a new resource.
- asn number
- Specifies the local BGP ASN of the virtual gateway.
The valid value is range from
1
to4,294,967,295
. Changing this will create a new resource. - dc
Virtual stringGateway V3Id - The ID of the virtual gateway.
- description string
- Specifies the description of the virtual gateway.
The description contain a maximum of 128 characters and the angle brackets (< and >) are not allowed.
Chinese characters must be in
UTF-8
orUnicode
format. - local
Ep string[]Group Ipv6s - Specifies the IPv6 subnets of the associated VPC that can be accessed over the virtual gateway.
- local
Ep string[]Groups - Specifies the list of IPv4 subnets from the virtual gateway to access cloud services, which is usually the CIDR block of the VPC.
- name string
- Specifies the name of the virtual gateway.
The valid length is limited from
3
to64
, only chinese and english letters, digits, hyphens (-), underscores (_) and dots (.) are allowed. The Chinese characters must be inUTF-8
orUnicode
format. - region string
- The region where the virtual gateway is located.
- status string
- The current status of the virtual gateway.
- vpc
Id string - Specifies the ID of the VPC connected to the virtual gateway. Changing this will create a new resource.
- asn float
- Specifies the local BGP ASN of the virtual gateway.
The valid value is range from
1
to4,294,967,295
. Changing this will create a new resource. - dc_
virtual_ strgateway_ v3_ id - The ID of the virtual gateway.
- description str
- Specifies the description of the virtual gateway.
The description contain a maximum of 128 characters and the angle brackets (< and >) are not allowed.
Chinese characters must be in
UTF-8
orUnicode
format. - local_
ep_ Sequence[str]group_ ipv6s - Specifies the IPv6 subnets of the associated VPC that can be accessed over the virtual gateway.
- local_
ep_ Sequence[str]groups - Specifies the list of IPv4 subnets from the virtual gateway to access cloud services, which is usually the CIDR block of the VPC.
- name str
- Specifies the name of the virtual gateway.
The valid length is limited from
3
to64
, only chinese and english letters, digits, hyphens (-), underscores (_) and dots (.) are allowed. The Chinese characters must be inUTF-8
orUnicode
format. - region str
- The region where the virtual gateway is located.
- status str
- The current status of the virtual gateway.
- vpc_
id str - Specifies the ID of the VPC connected to the virtual gateway. Changing this will create a new resource.
- asn Number
- Specifies the local BGP ASN of the virtual gateway.
The valid value is range from
1
to4,294,967,295
. Changing this will create a new resource. - dc
Virtual StringGateway V3Id - The ID of the virtual gateway.
- description String
- Specifies the description of the virtual gateway.
The description contain a maximum of 128 characters and the angle brackets (< and >) are not allowed.
Chinese characters must be in
UTF-8
orUnicode
format. - local
Ep List<String>Group Ipv6s - Specifies the IPv6 subnets of the associated VPC that can be accessed over the virtual gateway.
- local
Ep List<String>Groups - Specifies the list of IPv4 subnets from the virtual gateway to access cloud services, which is usually the CIDR block of the VPC.
- name String
- Specifies the name of the virtual gateway.
The valid length is limited from
3
to64
, only chinese and english letters, digits, hyphens (-), underscores (_) and dots (.) are allowed. The Chinese characters must be inUTF-8
orUnicode
format. - region String
- The region where the virtual gateway is located.
- status String
- The current status of the virtual gateway.
- vpc
Id String - Specifies the ID of the VPC connected to the virtual gateway. Changing this will create a new resource.
Import
Virtual gateways can be imported using their id
, e.g.
$ pulumi import opentelekomcloud:index/dcVirtualGatewayV3:DcVirtualGatewayV3 gw e41748a0-aed9-463e-9817-5c6162265d10
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.