This page documents the language specification for the alicloud package. If you're looking for help working with the inputs, outputs, or functions of alicloud resources in a Pulumi program, please see the resource documentation for examples and API reference.

vpc

This provider is a derived work of the Terraform Provider distributed under MPL 2.0. If you encounter a bug or missing feature, first check the pulumi/pulumi-alicloud repo; however, if that doesn’t turn up anything, please consult the source terraform-providers/terraform-provider-alicloud repo.

class pulumi_alicloud.vpc.AwaitableGetCommonBandwidthPackagesResult(id=None, ids=None, name_regex=None, names=None, output_file=None, packages=None, resource_group_id=None)
class pulumi_alicloud.vpc.AwaitableGetForwardEntriesResult(entries=None, external_ip=None, forward_table_id=None, id=None, ids=None, internal_ip=None, name_regex=None, names=None, output_file=None)
class pulumi_alicloud.vpc.AwaitableGetNatGatewaysResult(gateways=None, id=None, ids=None, name_regex=None, names=None, output_file=None, vpc_id=None)
class pulumi_alicloud.vpc.AwaitableGetNetworksResult(cidr_block=None, id=None, ids=None, is_default=None, name_regex=None, names=None, output_file=None, resource_group_id=None, status=None, tags=None, vpcs=None, vswitch_id=None)
class pulumi_alicloud.vpc.AwaitableGetRouteEntriesResult(cidr_block=None, entries=None, id=None, instance_id=None, output_file=None, route_table_id=None, type=None)
class pulumi_alicloud.vpc.AwaitableGetRouteTablesResult(id=None, ids=None, name_regex=None, names=None, output_file=None, resource_group_id=None, tables=None, tags=None, vpc_id=None)
class pulumi_alicloud.vpc.AwaitableGetRouterInterfacesResult(id=None, ids=None, interfaces=None, name_regex=None, names=None, opposite_interface_id=None, opposite_interface_owner_id=None, output_file=None, role=None, router_id=None, router_type=None, specification=None, status=None)
class pulumi_alicloud.vpc.AwaitableGetSnatEntriesResult(entries=None, id=None, ids=None, output_file=None, snat_ip=None, snat_table_id=None, source_cidr=None)
class pulumi_alicloud.vpc.AwaitableGetSslVpnClientCertsResult(certs=None, id=None, ids=None, name_regex=None, names=None, output_file=None, ssl_vpn_server_id=None)
class pulumi_alicloud.vpc.AwaitableGetSslVpnServersResult(id=None, ids=None, name_regex=None, names=None, output_file=None, servers=None, vpn_gateway_id=None)
class pulumi_alicloud.vpc.AwaitableGetSwitchesResult(cidr_block=None, id=None, ids=None, is_default=None, name_regex=None, names=None, output_file=None, resource_group_id=None, tags=None, vpc_id=None, vswitches=None, zone_id=None)
class pulumi_alicloud.vpc.CommonBandwithPackage(resource_name, opts=None, bandwidth=None, description=None, internet_charge_type=None, name=None, ratio=None, resource_group_id=None, __props__=None, __name__=None, __opts__=None)

Create a CommonBandwithPackage resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[float] bandwidth: The bandwidth of the common bandwidth package, in Mbps. :param pulumi.Input[str] description: The description of the common bandwidth package instance. :param pulumi.Input[str] internet_charge_type: The billing method of the common bandwidth package. Valid values are “PayByBandwidth” and “PayBy95” and “PayByTraffic”. “PayBy95” is pay by classic 95th percentile pricing. International Account doesn’t supports “PayByBandwidth” and “PayBy95”. Default to “PayByTraffic”. :param pulumi.Input[str] name: The name of the common bandwidth package. :param pulumi.Input[float] ratio: Ratio of the common bandwidth package. It is valid when internet_charge_type is PayBy95. Default to 100. Valid values: [10-100]. :param pulumi.Input[str] resource_group_id: The Id of resource group which the common bandwidth package belongs.

bandwidth: pulumi.Output[float] = None

The bandwidth of the common bandwidth package, in Mbps.

description: pulumi.Output[str] = None

The description of the common bandwidth package instance.

internet_charge_type: pulumi.Output[str] = None

The billing method of the common bandwidth package. Valid values are “PayByBandwidth” and “PayBy95” and “PayByTraffic”. “PayBy95” is pay by classic 95th percentile pricing. International Account doesn’t supports “PayByBandwidth” and “PayBy95”. Default to “PayByTraffic”.

name: pulumi.Output[str] = None

The name of the common bandwidth package.

ratio: pulumi.Output[float] = None

Ratio of the common bandwidth package. It is valid when internet_charge_type is PayBy95. Default to 100. Valid values: [10-100].

resource_group_id: pulumi.Output[str] = None

The Id of resource group which the common bandwidth package belongs.

static get(resource_name, id, opts=None, bandwidth=None, description=None, internet_charge_type=None, name=None, ratio=None, resource_group_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • bandwidth (pulumi.Input[float]) – The bandwidth of the common bandwidth package, in Mbps.

  • description (pulumi.Input[str]) – The description of the common bandwidth package instance.

  • internet_charge_type (pulumi.Input[str]) – The billing method of the common bandwidth package. Valid values are “PayByBandwidth” and “PayBy95” and “PayByTraffic”. “PayBy95” is pay by classic 95th percentile pricing. International Account doesn’t supports “PayByBandwidth” and “PayBy95”. Default to “PayByTraffic”.

  • name (pulumi.Input[str]) – The name of the common bandwidth package.

  • ratio (pulumi.Input[float]) – Ratio of the common bandwidth package. It is valid when internet_charge_type is PayBy95. Default to 100. Valid values: [10-100].

  • resource_group_id (pulumi.Input[str]) – The Id of resource group which the common bandwidth package belongs.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.CommonBandwithPackageAttachment(resource_name, opts=None, bandwidth_package_id=None, instance_id=None, __props__=None, __name__=None, __opts__=None)

Create a CommonBandwithPackageAttachment resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[str] bandwidth_package_id: The bandwidth_package_id of the common bandwidth package attachment, the field can’t be changed. :param pulumi.Input[str] instance_id: The instance_id of the common bandwidth package attachment, the field can’t be changed.

bandwidth_package_id: pulumi.Output[str] = None

The bandwidth_package_id of the common bandwidth package attachment, the field can’t be changed.

instance_id: pulumi.Output[str] = None

The instance_id of the common bandwidth package attachment, the field can’t be changed.

static get(resource_name, id, opts=None, bandwidth_package_id=None, instance_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • bandwidth_package_id (pulumi.Input[str]) – The bandwidth_package_id of the common bandwidth package attachment, the field can’t be changed.

  • instance_id (pulumi.Input[str]) – The instance_id of the common bandwidth package attachment, the field can’t be changed.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.ForwardEntry(resource_name, opts=None, external_ip=None, external_port=None, forward_table_id=None, internal_ip=None, internal_port=None, ip_protocol=None, name=None, __props__=None, __name__=None, __opts__=None)

Provides a forward resource.

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "forward-entry-example-name"
default_zones = alicloud.get_zones(available_resource_creation="VSwitch")
default_network = alicloud.vpc.Network("defaultNetwork", cidr_block="172.16.0.0/12")
default_switch = alicloud.vpc.Switch("defaultSwitch",
    availability_zone=default_zones.zones[0]["id"],
    cidr_block="172.16.0.0/21",
    vpc_id=default_network.id)
default_nat_gateway = alicloud.vpc.NatGateway("defaultNatGateway",
    specification="Small",
    vpc_id=default_network.id)
default_eip = alicloud.ecs.Eip("defaultEip")
default_eip_association = alicloud.ecs.EipAssociation("defaultEipAssociation",
    allocation_id=default_eip.id,
    instance_id=default_nat_gateway.id)
default_forward_entry = alicloud.vpc.ForwardEntry("defaultForwardEntry",
    external_ip=default_eip.ip_address,
    external_port="80",
    forward_table_id=default_nat_gateway.forward_table_ids,
    internal_ip="172.16.0.3",
    internal_port="8080",
    ip_protocol="tcp")
Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • external_ip (pulumi.Input[str]) – The external ip address, the ip must along bandwidth package public ip which vpc.NatGateway argument bandwidth_packages.

  • external_port (pulumi.Input[str]) – The external port, valid value is 1~65535|any.

  • forward_table_id (pulumi.Input[str]) – The value can get from vpc.NatGateway Attributes “forward_table_ids”.

  • internal_ip (pulumi.Input[str]) – The internal ip, must a private ip.

  • internal_port (pulumi.Input[str]) – The internal port, valid value is 1~65535|any.

  • ip_protocol (pulumi.Input[str]) – The ip protocal, valid value is tcp|udp|any.

  • name (pulumi.Input[str]) – The name of forward entry.

external_ip: pulumi.Output[str] = None

The external ip address, the ip must along bandwidth package public ip which vpc.NatGateway argument bandwidth_packages.

external_port: pulumi.Output[str] = None

The external port, valid value is 1~65535|any.

forward_entry_id: pulumi.Output[str] = None

The id of the forward entry on the server.

forward_table_id: pulumi.Output[str] = None

The value can get from vpc.NatGateway Attributes “forward_table_ids”.

internal_ip: pulumi.Output[str] = None

The internal ip, must a private ip.

internal_port: pulumi.Output[str] = None

The internal port, valid value is 1~65535|any.

ip_protocol: pulumi.Output[str] = None

The ip protocal, valid value is tcp|udp|any.

name: pulumi.Output[str] = None

The name of forward entry.

static get(resource_name, id, opts=None, external_ip=None, external_port=None, forward_entry_id=None, forward_table_id=None, internal_ip=None, internal_port=None, ip_protocol=None, name=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • external_ip (pulumi.Input[str]) – The external ip address, the ip must along bandwidth package public ip which vpc.NatGateway argument bandwidth_packages.

  • external_port (pulumi.Input[str]) – The external port, valid value is 1~65535|any.

  • forward_entry_id (pulumi.Input[str]) – The id of the forward entry on the server.

  • forward_table_id (pulumi.Input[str]) – The value can get from vpc.NatGateway Attributes “forward_table_ids”.

  • internal_ip (pulumi.Input[str]) – The internal ip, must a private ip.

  • internal_port (pulumi.Input[str]) – The internal port, valid value is 1~65535|any.

  • ip_protocol (pulumi.Input[str]) – The ip protocal, valid value is tcp|udp|any.

  • name (pulumi.Input[str]) – The name of forward entry.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.GetCommonBandwidthPackagesResult(id=None, ids=None, name_regex=None, names=None, output_file=None, packages=None, resource_group_id=None)

A collection of values returned by getCommonBandwidthPackages.

id = None

The provider-assigned unique ID for this managed resource.

ids = None

(Optional) A list of Common Bandwidth Packages IDs.

names = None

A list of Common Bandwidth Packages names.

packages = None

A list of Common Bandwidth Packages. Each element contains the following attributes:

resource_group_id = None

The Id of resource group which the common bandwidth package belongs.

class pulumi_alicloud.vpc.GetForwardEntriesResult(entries=None, external_ip=None, forward_table_id=None, id=None, ids=None, internal_ip=None, name_regex=None, names=None, output_file=None)

A collection of values returned by getForwardEntries.

entries = None

A list of Forward Entries. Each element contains the following attributes:

external_ip = None

The public IP address.

id = None

The provider-assigned unique ID for this managed resource.

ids = None

A list of Forward Entries IDs.

internal_ip = None

The private IP address.

names = None

A list of Forward Entries names.

class pulumi_alicloud.vpc.GetNatGatewaysResult(gateways=None, id=None, ids=None, name_regex=None, names=None, output_file=None, vpc_id=None)

A collection of values returned by getNatGateways.

gateways = None

A list of Nat gateways. Each element contains the following attributes:

id = None

The provider-assigned unique ID for this managed resource.

ids = None

(Optional) A list of Nat gateways IDs.

names = None

A list of Nat gateways names.

vpc_id = None

The ID of the VPC.

class pulumi_alicloud.vpc.GetNetworksResult(cidr_block=None, id=None, ids=None, is_default=None, name_regex=None, names=None, output_file=None, resource_group_id=None, status=None, tags=None, vpcs=None, vswitch_id=None)

A collection of values returned by getNetworks.

cidr_block = None

CIDR block of the VPC.

id = None

The provider-assigned unique ID for this managed resource.

ids = None

A list of VPC IDs.

is_default = None

Whether the VPC is the default VPC in the region.

names = None

A list of VPC names.

status = None

Status of the VPC.

tags = None

A map of tags assigned to the VPC.

vpcs = None

A list of VPCs. Each element contains the following attributes:

class pulumi_alicloud.vpc.GetRouteEntriesResult(cidr_block=None, entries=None, id=None, instance_id=None, output_file=None, route_table_id=None, type=None)

A collection of values returned by getRouteEntries.

cidr_block = None

The destination CIDR block of the route entry.

entries = None

A list of Route Entries. Each element contains the following attributes:

id = None

The provider-assigned unique ID for this managed resource.

instance_id = None

The instance ID of the next hop.

route_table_id = None

The ID of the router table to which the route entry belongs.

type = None

The type of the route entry.

class pulumi_alicloud.vpc.GetRouteTablesResult(id=None, ids=None, name_regex=None, names=None, output_file=None, resource_group_id=None, tables=None, tags=None, vpc_id=None)

A collection of values returned by getRouteTables.

id = None

The provider-assigned unique ID for this managed resource.

ids = None

(Optional) A list of Route Tables IDs.

names = None

A list of Route Tables names.

resource_group_id = None

The Id of resource group which route tables belongs.

tables = None

A list of Route Tables. Each element contains the following attributes:

class pulumi_alicloud.vpc.GetRouterInterfacesResult(id=None, ids=None, interfaces=None, name_regex=None, names=None, opposite_interface_id=None, opposite_interface_owner_id=None, output_file=None, role=None, router_id=None, router_type=None, specification=None, status=None)

A collection of values returned by getRouterInterfaces.

id = None

The provider-assigned unique ID for this managed resource.

ids = None

A list of router interface IDs.

interfaces = None

A list of router interfaces. Each element contains the following attributes:

names = None

A list of router interface names.

opposite_interface_id = None

Peer router interface ID.

opposite_interface_owner_id = None

Account ID of the owner of the peer router interface.

role = None

Router interface role. Possible values: InitiatingSide and AcceptingSide.

router_id = None

ID of the VRouter located in the local region.

router_type = None

Router type in the local region. Possible values: VRouter and VBR.

specification = None

Router interface specification. Possible values: Small.1, Middle.1, Large.2, …etc.

status = None

Router interface status. Possible values: Active, Inactive and Idle.

class pulumi_alicloud.vpc.GetSnatEntriesResult(entries=None, id=None, ids=None, output_file=None, snat_ip=None, snat_table_id=None, source_cidr=None)

A collection of values returned by getSnatEntries.

entries = None

A list of Snat Entries. Each element contains the following attributes:

id = None

The provider-assigned unique ID for this managed resource.

ids = None

(Optional) A list of Snat Entries IDs.

snat_ip = None

The public IP of the Snat Entry.

source_cidr = None

The source CIDR block of the Snat Entry.

class pulumi_alicloud.vpc.GetSslVpnClientCertsResult(certs=None, id=None, ids=None, name_regex=None, names=None, output_file=None, ssl_vpn_server_id=None)

A collection of values returned by getSslVpnClientCerts.

id = None

The provider-assigned unique ID for this managed resource.

ids = None

A list of SSL-VPN client cert IDs.

names = None

A list of SSL-VPN client cert names.

ssl_vpn_server_id = None

ID of the SSL-VPN Server.

class pulumi_alicloud.vpc.GetSslVpnServersResult(id=None, ids=None, name_regex=None, names=None, output_file=None, servers=None, vpn_gateway_id=None)

A collection of values returned by getSslVpnServers.

id = None

The provider-assigned unique ID for this managed resource.

ids = None

A list of SSL-VPN server IDs.

names = None

A list of SSL-VPN server names.

servers = None

A list of SSL-VPN servers. Each element contains the following attributes:

vpn_gateway_id = None

The ID of the VPN gateway instance.

class pulumi_alicloud.vpc.GetSwitchesResult(cidr_block=None, id=None, ids=None, is_default=None, name_regex=None, names=None, output_file=None, resource_group_id=None, tags=None, vpc_id=None, vswitches=None, zone_id=None)

A collection of values returned by getSwitches.

cidr_block = None

CIDR block of the VSwitch.

id = None

The provider-assigned unique ID for this managed resource.

ids = None

A list of VSwitch IDs.

is_default = None

Whether the VSwitch is the default one in the region.

names = None

A list of VSwitch names.

vpc_id = None

ID of the VPC that owns the VSwitch.

vswitches = None

A list of VSwitches. Each element contains the following attributes:

zone_id = None

ID of the availability zone where the VSwitch is located.

class pulumi_alicloud.vpc.HAVip(resource_name, opts=None, description=None, ip_address=None, vswitch_id=None, __props__=None, __name__=None, __opts__=None)

Create a HAVip resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[str] description: The description of the HaVip instance. :param pulumi.Input[str] ip_address: The ip address of the HaVip. If not filled, the default will be assigned one from the vswitch. :param pulumi.Input[str] vswitch_id: The vswitch_id of the HaVip, the field can’t be changed.

description: pulumi.Output[str] = None

The description of the HaVip instance.

ip_address: pulumi.Output[str] = None

The ip address of the HaVip. If not filled, the default will be assigned one from the vswitch.

vswitch_id: pulumi.Output[str] = None

The vswitch_id of the HaVip, the field can’t be changed.

static get(resource_name, id, opts=None, description=None, ip_address=None, vswitch_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • description (pulumi.Input[str]) – The description of the HaVip instance.

  • ip_address (pulumi.Input[str]) – The ip address of the HaVip. If not filled, the default will be assigned one from the vswitch.

  • vswitch_id (pulumi.Input[str]) – The vswitch_id of the HaVip, the field can’t be changed.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.HAVipAttachment(resource_name, opts=None, havip_id=None, instance_id=None, __props__=None, __name__=None, __opts__=None)

Create a HAVipAttachment resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[str] havip_id: The havip_id of the havip attachment, the field can’t be changed. :param pulumi.Input[str] instance_id: The instance_id of the havip attachment, the field can’t be changed.

havip_id: pulumi.Output[str] = None

The havip_id of the havip attachment, the field can’t be changed.

instance_id: pulumi.Output[str] = None

The instance_id of the havip attachment, the field can’t be changed.

static get(resource_name, id, opts=None, havip_id=None, instance_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • havip_id (pulumi.Input[str]) – The havip_id of the havip attachment, the field can’t be changed.

  • instance_id (pulumi.Input[str]) – The instance_id of the havip attachment, the field can’t be changed.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.NatGateway(resource_name, opts=None, bandwidth_packages=None, description=None, instance_charge_type=None, name=None, period=None, spec=None, specification=None, vpc_id=None, __props__=None, __name__=None, __opts__=None)

Create a NatGateway resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[list] bandwidth_packages: A list of bandwidth packages for the nat gatway. Only support nat gateway created before 00:00 on November 4, 2017. Available in v1.13.0+ and v1.7.1-. :param pulumi.Input[str] description: Description of the nat gateway, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Defaults to null. :param pulumi.Input[str] instance_chargetype: The billing method of the nat gateway. Valid values are “PrePaid” and “PostPaid”. Default to “PostPaid”. :param pulumi.Input[str] name: Name of the nat gateway. The value can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as “-“,”.”,””, and must not begin or end with a hyphen, and must not begin with http:// or https://. Defaults to null. :param pulumi.Input[float] period: The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid values: [1-9, 12, 24, 36]. At present, the provider does not support modify “period” and you can do that via web console. :param pulumi.Input[str] spec: It has been deprecated from provider version 1.7.1, and new field ‘specification’ can replace it. :param pulumi.Input[str] specification: The specification of the nat gateway. Valid values are Small, Middle and Large. Default to Small. Details refer to Nat Gateway Specification. :param pulumi.Input[str] vpc_id: The VPC ID.

The bandwidth_packages object supports the following:

  • bandwidth (pulumi.Input[float])

  • ip_count (pulumi.Input[float])

  • publicIpAddresses (pulumi.Input[str])

  • zone (pulumi.Input[str])

bandwidth_package_ids: pulumi.Output[str] = None

A list ID of the bandwidth packages, and split them with commas.

bandwidth_packages: pulumi.Output[list] = None

A list of bandwidth packages for the nat gatway. Only support nat gateway created before 00:00 on November 4, 2017. Available in v1.13.0+ and v1.7.1-.

  • bandwidth (float)

  • ip_count (float)

  • publicIpAddresses (str)

  • zone (str)

description: pulumi.Output[str] = None

Description of the nat gateway, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Defaults to null.

forward_table_ids: pulumi.Output[str] = None

The nat gateway will auto create a snap and forward item, the forward_table_ids is the created one.

instance_charge_type: pulumi.Output[str] = None

The billing method of the nat gateway. Valid values are “PrePaid” and “PostPaid”. Default to “PostPaid”.

name: pulumi.Output[str] = None

Name of the nat gateway. The value can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as “-“,”.”,”_”, and must not begin or end with a hyphen, and must not begin with http:// or https://. Defaults to null.

period: pulumi.Output[float] = None

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid values: [1-9, 12, 24, 36]. At present, the provider does not support modify “period” and you can do that via web console.

snat_table_ids: pulumi.Output[str] = None

The nat gateway will auto create a snap and forward item, the snat_table_ids is the created one.

spec: pulumi.Output[str] = None

It has been deprecated from provider version 1.7.1, and new field ‘specification’ can replace it.

specification: pulumi.Output[str] = None

The specification of the nat gateway. Valid values are Small, Middle and Large. Default to Small. Details refer to Nat Gateway Specification.

vpc_id: pulumi.Output[str] = None

The VPC ID.

static get(resource_name, id, opts=None, bandwidth_package_ids=None, bandwidth_packages=None, description=None, forward_table_ids=None, instance_charge_type=None, name=None, period=None, snat_table_ids=None, spec=None, specification=None, vpc_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • bandwidth_package_ids (pulumi.Input[str]) – A list ID of the bandwidth packages, and split them with commas.

  • bandwidth_packages (pulumi.Input[list]) – A list of bandwidth packages for the nat gatway. Only support nat gateway created before 00:00 on November 4, 2017. Available in v1.13.0+ and v1.7.1-.

  • description (pulumi.Input[str]) – Description of the nat gateway, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Defaults to null.

  • forward_table_ids (pulumi.Input[str]) – The nat gateway will auto create a snap and forward item, the forward_table_ids is the created one.

  • instance_charge*type (pulumi.Input[str]) –

    The billing method of the nat gateway. Valid values are “PrePaid” and “PostPaid”. Default to “PostPaid”.

  • name (pulumi.Input[str]) – Name of the nat gateway. The value can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as “-“,”.”,”*”, and must not begin or end with a hyphen, and must not begin with http:// or https://. Defaults to null.

  • period (pulumi.Input[float]) – The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid values: [1-9, 12, 24, 36]. At present, the provider does not support modify “period” and you can do that via web console.

  • snat_table_ids (pulumi.Input[str]) – The nat gateway will auto create a snap and forward item, the snat_table_ids is the created one.

  • spec (pulumi.Input[str]) – It has been deprecated from provider version 1.7.1, and new field ‘specification’ can replace it.

  • specification (pulumi.Input[str]) –

    The specification of the nat gateway. Valid values are Small, Middle and Large. Default to Small. Details refer to Nat Gateway Specification.

  • vpc_id (pulumi.Input[str]) – The VPC ID.

The bandwidth_packages object supports the following:

  • bandwidth (pulumi.Input[float])

  • ip_count (pulumi.Input[float])

  • publicIpAddresses (pulumi.Input[str])

  • zone (pulumi.Input[str])

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.Network(resource_name, opts=None, cidr_block=None, description=None, name=None, resource_group_id=None, tags=None, __props__=None, __name__=None, __opts__=None)

Create a Network resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[str] cidr_block: The CIDR block for the VPC. :param pulumi.Input[str] description: The VPC description. Defaults to null. :param pulumi.Input[str] name: The name of the VPC. Defaults to null. :param pulumi.Input[str] resource_group_id: The Id of resource group which the VPC belongs. :param pulumi.Input[dict] tags: A mapping of tags to assign to the resource.

cidr_block: pulumi.Output[str] = None

The CIDR block for the VPC.

description: pulumi.Output[str] = None

The VPC description. Defaults to null.

name: pulumi.Output[str] = None

The name of the VPC. Defaults to null.

resource_group_id: pulumi.Output[str] = None

The Id of resource group which the VPC belongs.

route_table_id: pulumi.Output[str] = None

The route table ID of the router created by default on VPC creation.

router_id: pulumi.Output[str] = None

The ID of the router created by default on VPC creation.

tags: pulumi.Output[dict] = None

A mapping of tags to assign to the resource.

static get(resource_name, id, opts=None, cidr_block=None, description=None, name=None, resource_group_id=None, route_table_id=None, router_id=None, router_table_id=None, tags=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • cidr_block (pulumi.Input[str]) – The CIDR block for the VPC.

  • description (pulumi.Input[str]) – The VPC description. Defaults to null.

  • name (pulumi.Input[str]) – The name of the VPC. Defaults to null.

  • resource_group_id (pulumi.Input[str]) – The Id of resource group which the VPC belongs.

  • route_table_id (pulumi.Input[str]) – The route table ID of the router created by default on VPC creation.

  • router_id (pulumi.Input[str]) – The ID of the router created by default on VPC creation.

  • tags (pulumi.Input[dict]) – A mapping of tags to assign to the resource.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.NetworkAcl(resource_name, opts=None, description=None, name=None, vpc_id=None, __props__=None, __name__=None, __opts__=None)

Provides a network acl resource to add network acls.

NOTE: Available in 1.43.0+. Currently, the resource are only available in Hongkong(cn-hongkong), India(ap-south-1), and Indonesia(ap-southeast-1) regions.

import pulumi
import pulumi_alicloud as alicloud

default_network = alicloud.vpc.Network("defaultNetwork", cidr_block="172.16.0.0/12")
default_network_acl = alicloud.vpc.NetworkAcl("defaultNetworkAcl",
    description="network_acl",
    vpc_id=default_network.id)
Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • description (pulumi.Input[str]) – The description of the network acl instance.

  • name (pulumi.Input[str]) – The name of the network acl.

  • vpc_id (pulumi.Input[str]) – The vpc_id of the network acl, the field can’t be changed.

description: pulumi.Output[str] = None

The description of the network acl instance.

name: pulumi.Output[str] = None

The name of the network acl.

vpc_id: pulumi.Output[str] = None

The vpc_id of the network acl, the field can’t be changed.

static get(resource_name, id, opts=None, description=None, name=None, vpc_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • description (pulumi.Input[str]) – The description of the network acl instance.

  • name (pulumi.Input[str]) – The name of the network acl.

  • vpc_id (pulumi.Input[str]) – The vpc_id of the network acl, the field can’t be changed.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.NetworkAclAttachment(resource_name, opts=None, network_acl_id=None, resources=None, __props__=None, __name__=None, __opts__=None)

Provides a network acl attachment resource to associate network acls to vswitches.

NOTE: Available in 1.44.0+. Currently, the resource are only available in Hongkong(cn-hongkong), India(ap-south-1), and Indonesia(ap-southeast-1) regions.

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "NatGatewayConfigSpec"
default_zones = alicloud.get_zones(available_resource_creation="VSwitch")
default_network = alicloud.vpc.Network("defaultNetwork", cidr_block="172.16.0.0/12")
default_network_acl = alicloud.vpc.NetworkAcl("defaultNetworkAcl", vpc_id=default_network.id)
default_switch = alicloud.vpc.Switch("defaultSwitch",
    availability_zone=default_zones.zones[0]["id"],
    cidr_block="172.16.0.0/21",
    vpc_id=default_network.id)
default_network_acl_attachment = alicloud.vpc.NetworkAclAttachment("defaultNetworkAclAttachment",
    network_acl_id=default_network_acl.id,
    resources=[{
        "resourceId": default_switch.id,
        "resourceType": "VSwitch",
    }])
Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • network_acl_id (pulumi.Input[str]) – The id of the network acl, the field can’t be changed.

  • resources (pulumi.Input[list]) – List of the resources associated with the network acl. The details see Block Resources.

The resources object supports the following:

  • resourceId (pulumi.Input[str]) - The resource id that the network acl will associate with.

  • resourceType (pulumi.Input[str]) - The resource id that the network acl will associate with. Only support VSwitch now.

network_acl_id: pulumi.Output[str] = None

The id of the network acl, the field can’t be changed.

resources: pulumi.Output[list] = None

List of the resources associated with the network acl. The details see Block Resources.

  • resourceId (str) - The resource id that the network acl will associate with.

  • resourceType (str) - The resource id that the network acl will associate with. Only support VSwitch now.

static get(resource_name, id, opts=None, network_acl_id=None, resources=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • network_acl_id (pulumi.Input[str]) – The id of the network acl, the field can’t be changed.

  • resources (pulumi.Input[list]) – List of the resources associated with the network acl. The details see Block Resources.

The resources object supports the following:

  • resourceId (pulumi.Input[str]) - The resource id that the network acl will associate with.

  • resourceType (pulumi.Input[str]) - The resource id that the network acl will associate with. Only support VSwitch now.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.NetworkAclEntries(resource_name, opts=None, egresses=None, ingresses=None, network_acl_id=None, __props__=None, __name__=None, __opts__=None)

Provides a network acl entries resource to create ingress and egress entries.

NOTE: Available in 1.45.0+. Currently, the resource are only available in Hongkong(cn-hongkong), India(ap-south-1), and Indonesia(ap-southeast-1) regions.

NOTE: It doesn’t support concurrency and the order of the ingress and egress entries determines the priority.

NOTE: Using this resource need to open a whitelist.

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "NetworkAclEntries"
default_zones = alicloud.get_zones(available_resource_creation="VSwitch")
default_network = alicloud.vpc.Network("defaultNetwork", cidr_block="172.16.0.0/12")
default_network_acl = alicloud.vpc.NetworkAcl("defaultNetworkAcl", vpc_id=default_network.id)
default_switch = alicloud.vpc.Switch("defaultSwitch",
    availability_zone=default_zones.zones[0]["id"],
    cidr_block="172.16.0.0/21",
    vpc_id=default_network.id)
default_network_acl_attachment = alicloud.vpc.NetworkAclAttachment("defaultNetworkAclAttachment",
    network_acl_id=default_network_acl.id,
    resources=[{
        "resourceId": default_switch.id,
        "resourceType": "VSwitch",
    }])
default_network_acl_entries = alicloud.vpc.NetworkAclEntries("defaultNetworkAclEntries",
    egresses=[{
        "description": name,
        "destinationCidrIp": "0.0.0.0/32",
        "entryType": "custom",
        "name": name,
        "policy": "accept",
        "port": "-1/-1",
        "protocol": "all",
    }],
    ingresses=[{
        "description": name,
        "entryType": "custom",
        "name": name,
        "policy": "accept",
        "port": "-1/-1",
        "protocol": "all",
        "source_cidr_ip": "0.0.0.0/32",
    }],
    network_acl_id=default_network_acl.id)
Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • egresses (pulumi.Input[list]) – List of the egress entries of the network acl. The order of the egress entries determines the priority. The details see Block Egress.

  • ingresses (pulumi.Input[list]) – List of the ingress entries of the network acl. The order of the ingress entries determines the priority. The details see Block Ingress.

  • network_acl_id (pulumi.Input[str]) – The id of the network acl, the field can’t be changed.

The egresses object supports the following:

  • description (pulumi.Input[str]) - The description of the egress entry.

  • destinationCidrIp (pulumi.Input[str]) - The destination ip of the egress entry.

  • entryType (pulumi.Input[str]) - The entry type of the egress entry. It must be custom or system. Default value is custom.

  • name (pulumi.Input[str]) - The name of the egress entry.

  • policy (pulumi.Input[str]) - The policy of the egress entry. It must be accept or drop.

  • port (pulumi.Input[str]) - The port of the egress entry.

  • protocol (pulumi.Input[str]) - The protocol of the egress entry.

The ingresses object supports the following:

  • description (pulumi.Input[str]) - The description of the egress entry.

  • entryType (pulumi.Input[str]) - The entry type of the egress entry. It must be custom or system. Default value is custom.

  • name (pulumi.Input[str]) - The name of the egress entry.

  • policy (pulumi.Input[str]) - The policy of the egress entry. It must be accept or drop.

  • port (pulumi.Input[str]) - The port of the egress entry.

  • protocol (pulumi.Input[str]) - The protocol of the egress entry.

  • source_cidr_ip (pulumi.Input[str]) - The source ip of the ingress entry.

egresses: pulumi.Output[list] = None

List of the egress entries of the network acl. The order of the egress entries determines the priority. The details see Block Egress.

  • description (str) - The description of the egress entry.

  • destinationCidrIp (str) - The destination ip of the egress entry.

  • entryType (str) - The entry type of the egress entry. It must be custom or system. Default value is custom.

  • name (str) - The name of the egress entry.

  • policy (str) - The policy of the egress entry. It must be accept or drop.

  • port (str) - The port of the egress entry.

  • protocol (str) - The protocol of the egress entry.

ingresses: pulumi.Output[list] = None

List of the ingress entries of the network acl. The order of the ingress entries determines the priority. The details see Block Ingress.

  • description (str) - The description of the egress entry.

  • entryType (str) - The entry type of the egress entry. It must be custom or system. Default value is custom.

  • name (str) - The name of the egress entry.

  • policy (str) - The policy of the egress entry. It must be accept or drop.

  • port (str) - The port of the egress entry.

  • protocol (str) - The protocol of the egress entry.

  • source_cidr_ip (str) - The source ip of the ingress entry.

network_acl_id: pulumi.Output[str] = None

The id of the network acl, the field can’t be changed.

static get(resource_name, id, opts=None, egresses=None, ingresses=None, network_acl_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • egresses (pulumi.Input[list]) – List of the egress entries of the network acl. The order of the egress entries determines the priority. The details see Block Egress.

  • ingresses (pulumi.Input[list]) – List of the ingress entries of the network acl. The order of the ingress entries determines the priority. The details see Block Ingress.

  • network_acl_id (pulumi.Input[str]) – The id of the network acl, the field can’t be changed.

The egresses object supports the following:

  • description (pulumi.Input[str]) - The description of the egress entry.

  • destinationCidrIp (pulumi.Input[str]) - The destination ip of the egress entry.

  • entryType (pulumi.Input[str]) - The entry type of the egress entry. It must be custom or system. Default value is custom.

  • name (pulumi.Input[str]) - The name of the egress entry.

  • policy (pulumi.Input[str]) - The policy of the egress entry. It must be accept or drop.

  • port (pulumi.Input[str]) - The port of the egress entry.

  • protocol (pulumi.Input[str]) - The protocol of the egress entry.

The ingresses object supports the following:

  • description (pulumi.Input[str]) - The description of the egress entry.

  • entryType (pulumi.Input[str]) - The entry type of the egress entry. It must be custom or system. Default value is custom.

  • name (pulumi.Input[str]) - The name of the egress entry.

  • policy (pulumi.Input[str]) - The policy of the egress entry. It must be accept or drop.

  • port (pulumi.Input[str]) - The port of the egress entry.

  • protocol (pulumi.Input[str]) - The protocol of the egress entry.

  • source_cidr_ip (pulumi.Input[str]) - The source ip of the ingress entry.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.NetworkInterface(resource_name, opts=None, description=None, name=None, private_ip=None, private_ips=None, private_ips_count=None, resource_group_id=None, security_groups=None, tags=None, vswitch_id=None, __props__=None, __name__=None, __opts__=None)

Provides an ECS Elastic Network Interface resource.

For information about Elastic Network Interface and how to use it, see Elastic Network Interface.

NOTE Only one of private_ips or private_ips_count can be specified when assign private IPs.

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "networkInterfaceName"
vpc = alicloud.vpc.Network("vpc", cidr_block="192.168.0.0/24")
default_zones = alicloud.get_zones(available_resource_creation="VSwitch")
vswitch = alicloud.vpc.Switch("vswitch",
    availability_zone=default_zones.zones[0]["id"],
    cidr_block="192.168.0.0/24",
    vpc_id=vpc.id)
group = alicloud.ecs.SecurityGroup("group", vpc_id=vpc.id)
default_network_interface = alicloud.vpc.NetworkInterface("defaultNetworkInterface",
    private_ip="192.168.0.2",
    private_ips_count=3,
    security_groups=[group.id],
    vswitch_id=vswitch.id)
Parameters
  • resource*name (str) –

    The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • description (pulumi.Input[str]) – Description of the ENI. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

  • name (pulumi.Input[str]) – Name of the ENI. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as “-“, “.”, “*”, and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

  • private_ip (pulumi.Input[str]) – The primary private IP of the ENI.

  • private_ips (pulumi.Input[list]) – List of secondary private IPs to assign to the ENI. Don’t use both private_ips and private_ips_count in the same ENI resource block.

  • private_ips_count (pulumi.Input[float]) – Number of secondary private IPs to assign to the ENI. Don’t use both private_ips and private_ips_count in the same ENI resource block.

  • resource_group_id (pulumi.Input[str]) – The Id of resource group which the network interface belongs.

  • security_groups (pulumi.Input[list]) – A list of security group ids to associate with.

  • tags (pulumi.Input[dict]) – A mapping of tags to assign to the resource.

  • vswitch_id (pulumi.Input[str]) – The VSwitch to create the ENI in.

description: pulumi.Output[str] = None

Description of the ENI. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

mac: pulumi.Output[str] = None

(Available in 1.54.0+) The MAC address of an ENI.

name: pulumi.Output[str] = None

Name of the ENI. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as “-“, “.”, “_”, and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

private_ip: pulumi.Output[str] = None

The primary private IP of the ENI.

private_ips: pulumi.Output[list] = None

List of secondary private IPs to assign to the ENI. Don’t use both private_ips and private_ips_count in the same ENI resource block.

private_ips_count: pulumi.Output[float] = None

Number of secondary private IPs to assign to the ENI. Don’t use both private_ips and private_ips_count in the same ENI resource block.

resource_group_id: pulumi.Output[str] = None

The Id of resource group which the network interface belongs.

security_groups: pulumi.Output[list] = None

A list of security group ids to associate with.

tags: pulumi.Output[dict] = None

A mapping of tags to assign to the resource.

vswitch_id: pulumi.Output[str] = None

The VSwitch to create the ENI in.

static get(resource_name, id, opts=None, description=None, mac=None, name=None, private_ip=None, private_ips=None, private_ips_count=None, resource_group_id=None, security_groups=None, tags=None, vswitch_id=None)

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

Parameters
  • resource*name (str) –

    The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • description (pulumi.Input[str]) – Description of the ENI. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

  • mac (pulumi.Input[str]) – (Available in 1.54.0+) The MAC address of an ENI.

  • name (pulumi.Input[str]) – Name of the ENI. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as “-“, “.”, “*”, and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

  • private_ip (pulumi.Input[str]) – The primary private IP of the ENI.

  • private_ips (pulumi.Input[list]) – List of secondary private IPs to assign to the ENI. Don’t use both private_ips and private_ips_count in the same ENI resource block.

  • private_ips_count (pulumi.Input[float]) – Number of secondary private IPs to assign to the ENI. Don’t use both private_ips and private_ips_count in the same ENI resource block.

  • resource_group_id (pulumi.Input[str]) – The Id of resource group which the network interface belongs.

  • security_groups (pulumi.Input[list]) – A list of security group ids to associate with.

  • tags (pulumi.Input[dict]) – A mapping of tags to assign to the resource.

  • vswitch_id (pulumi.Input[str]) – The VSwitch to create the ENI in.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.NetworkInterfaceAttachment(resource_name, opts=None, instance_id=None, network_interface_id=None, __props__=None, __name__=None, __opts__=None)

Provides an Alicloud ECS Elastic Network Interface Attachment as a resource to attach ENI to or detach ENI from ECS Instances.

For information about Elastic Network Interface and how to use it, see Elastic Network Interface.

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "networkInterfaceAttachment"
number = config.get("number")
if number is None:
    number = "2"
vpc = alicloud.vpc.Network("vpc", cidr_block="192.168.0.0/24")
default_zones = alicloud.get_zones(available_resource_creation="VSwitch")
vswitch = alicloud.vpc.Switch("vswitch",
    availability_zone=default_zones.zones[0]["id"],
    cidr_block="192.168.0.0/24",
    vpc_id=vpc.id)
group = alicloud.ecs.SecurityGroup("group", vpc_id=vpc.id)
instance_type = alicloud.ecs.get_instance_types(availability_zone=default_zones.zones[0]["id"],
    eni_amount=2)
default_images = alicloud.ecs.get_images(most_recent=True,
    name_regex="^ubuntu_18.*64",
    owners="system")
instance = []
for range in [{"value": i} for i in range(0, number)]:
    instance.append(alicloud.ecs.Instance(f"instance-{range['value']}",
        availability_zone=default_zones.zones[0]["id"],
        image_id=default_images.images[0]["id"],
        instance_name=name,
        instance_type=instance_type.instance_types[0]["id"],
        internet_max_bandwidth_out=10,
        security_groups=[group.id],
        system_disk_category="cloud_efficiency",
        vswitch_id=vswitch.id))
interface = []
for range in [{"value": i} for i in range(0, number)]:
    interface.append(alicloud.vpc.NetworkInterface(f"interface-{range['value']}",
        security_groups=[group.id],
        vswitch_id=vswitch.id))
attachment = []
for range in [{"value": i} for i in range(0, number)]:
    attachment.append(alicloud.vpc.NetworkInterfaceAttachment(f"attachment-{range['value']}",
        instance_id=[__item.id for __item in instance][range["index"]],
        network_interface_id=[__item.id for __item in interface][range["index"]]))
Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • instance_id (pulumi.Input[str]) – The instance ID to attach.

  • network_interface_id (pulumi.Input[str]) – The ENI ID to attach.

instance_id: pulumi.Output[str] = None

The instance ID to attach.

network_interface_id: pulumi.Output[str] = None

The ENI ID to attach.

static get(resource_name, id, opts=None, instance_id=None, network_interface_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • instance_id (pulumi.Input[str]) – The instance ID to attach.

  • network_interface_id (pulumi.Input[str]) – The ENI ID to attach.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.RouteEntry(resource_name, opts=None, destination_cidrblock=None, name=None, nexthop_id=None, nexthop_type=None, route_table_id=None, router_id=None, __props__=None, __name__=None, __opts__=None)

Create a RouteEntry resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[str] destinationcidrblock: The RouteEntry’s target network segment. :param pulumi.Input[str] name: The name of the route entry. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as “-“,”.”,””, and must not begin or end with a hyphen, and must not begin with http:// or https://. :param pulumi.Input[str] nexthop_id: The route entry’s next hop. ECS instance ID or VPC router interface ID. :param pulumi.Input[str] nexthop_type: The next hop type. Available values:

- `Instance` (Default): Route the traffic destined for the destination CIDR block to an ECS instance in the VPC.
- `RouterInterface`: Route the traffic destined for the destination CIDR block to a router interface.
- `VpnGateway`: Route the traffic destined for the destination CIDR block to a VPN Gateway.
- `HaVip`: Route the traffic destined for the destination CIDR block to an HAVIP.
- `NetworkInterface`: Route the traffic destined for the destination CIDR block to an NetworkInterface.
- `NatGateway`: Route the traffic destined for the destination CIDR block to an Nat Gateway.
Parameters
  • route_table_id (pulumi.Input[str]) – The ID of the route table.

  • router_id (pulumi.Input[str]) – This argument has beeb deprecated. Please use other arguments to launch a custom route entry.

destination_cidrblock: pulumi.Output[str] = None

The RouteEntry’s target network segment.

name: pulumi.Output[str] = None

The name of the route entry. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as “-“,”.”,”_”, and must not begin or end with a hyphen, and must not begin with http:// or https://.

nexthop_id: pulumi.Output[str] = None

The route entry’s next hop. ECS instance ID or VPC router interface ID.

nexthop_type: pulumi.Output[str] = None

The next hop type. Available values:

  • Instance (Default): Route the traffic destined for the destination CIDR block to an ECS instance in the VPC.

  • RouterInterface: Route the traffic destined for the destination CIDR block to a router interface.

  • VpnGateway: Route the traffic destined for the destination CIDR block to a VPN Gateway.

  • HaVip: Route the traffic destined for the destination CIDR block to an HAVIP.

  • NetworkInterface: Route the traffic destined for the destination CIDR block to an NetworkInterface.

  • NatGateway: Route the traffic destined for the destination CIDR block to an Nat Gateway.

route_table_id: pulumi.Output[str] = None

The ID of the route table.

router_id: pulumi.Output[str] = None

This argument has beeb deprecated. Please use other arguments to launch a custom route entry.

static get(resource_name, id, opts=None, destination_cidrblock=None, name=None, nexthop_id=None, nexthop_type=None, route_table_id=None, router_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • destination*cidrblock (pulumi.Input[str]) –

    The RouteEntry’s target network segment.

  • name (pulumi.Input[str]) – The name of the route entry. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as “-“,”.”,”*”, and must not begin or end with a hyphen, and must not begin with http:// or https://.

  • nexthop_id (pulumi.Input[str]) – The route entry’s next hop. ECS instance ID or VPC router interface ID.

  • nexthop_type (pulumi.Input[str]) – The next hop type. Available values:

- `Instance` (Default): Route the traffic destined for the destination CIDR block to an ECS instance in the VPC.
- `RouterInterface`: Route the traffic destined for the destination CIDR block to a router interface.
- `VpnGateway`: Route the traffic destined for the destination CIDR block to a VPN Gateway.
- `HaVip`: Route the traffic destined for the destination CIDR block to an HAVIP.
- `NetworkInterface`: Route the traffic destined for the destination CIDR block to an NetworkInterface.
- `NatGateway`: Route the traffic destined for the destination CIDR block to an Nat Gateway.
Parameters
  • route_table_id (pulumi.Input[str]) – The ID of the route table.

  • router_id (pulumi.Input[str]) – This argument has beeb deprecated. Please use other arguments to launch a custom route entry.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.RouteTable(resource_name, opts=None, description=None, name=None, tags=None, vpc_id=None, __props__=None, __name__=None, __opts__=None)

Create a RouteTable resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[str] description: The description of the route table instance. :param pulumi.Input[str] name: The name of the route table. :param pulumi.Input[dict] tags: A mapping of tags to assign to the resource. :param pulumi.Input[str] vpc_id: The vpc_id of the route table, the field can’t be changed.

description: pulumi.Output[str] = None

The description of the route table instance.

name: pulumi.Output[str] = None

The name of the route table.

tags: pulumi.Output[dict] = None

A mapping of tags to assign to the resource.

vpc_id: pulumi.Output[str] = None

The vpc_id of the route table, the field can’t be changed.

static get(resource_name, id, opts=None, description=None, name=None, tags=None, vpc_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • description (pulumi.Input[str]) – The description of the route table instance.

  • name (pulumi.Input[str]) – The name of the route table.

  • tags (pulumi.Input[dict]) – A mapping of tags to assign to the resource.

  • vpc_id (pulumi.Input[str]) – The vpc_id of the route table, the field can’t be changed.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.RouteTableAttachment(resource_name, opts=None, route_table_id=None, vswitch_id=None, __props__=None, __name__=None, __opts__=None)

Create a RouteTableAttachment resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[str] route_table_id: The route_table_id of the route table attachment, the field can’t be changed. :param pulumi.Input[str] vswitch_id: The vswitch_id of the route table attachment, the field can’t be changed.

route_table_id: pulumi.Output[str] = None

The route_table_id of the route table attachment, the field can’t be changed.

vswitch_id: pulumi.Output[str] = None

The vswitch_id of the route table attachment, the field can’t be changed.

static get(resource_name, id, opts=None, route_table_id=None, vswitch_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • route_table_id (pulumi.Input[str]) – The route_table_id of the route table attachment, the field can’t be changed.

  • vswitch_id (pulumi.Input[str]) – The vswitch_id of the route table attachment, the field can’t be changed.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.RouterInterface(resource_name, opts=None, description=None, health_check_source_ip=None, health_check_target_ip=None, instance_charge_type=None, name=None, opposite_access_point_id=None, opposite_region=None, period=None, role=None, router_id=None, router_type=None, specification=None, __props__=None, __name__=None, __opts__=None)

Create a RouterInterface resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[str] description: Description of the router interface. It can be 2-256 characters long or left blank. It cannot start with http:// and https://. :param pulumi.Input[str] health_check_source_ip: Used as the Packet Source IP of health check for disaster recovery or ECMP. It is only valid when router_type is VBR. The IP must be an unused IP in the local VPC. It and health_check_target_ip must be specified at the same time. :param pulumi.Input[str] health_check_target_ip: Used as the Packet Target IP of health check for disaster recovery or ECMP. It is only valid when router_type is VBR. The IP must be an unused IP in the local VPC. It and health_check_source_ip must be specified at the same time. :param pulumi.Input[str] instance_charge_type: The billing method of the router interface. Valid values are “PrePaid” and “PostPaid”. Default to “PostPaid”. Router Interface doesn’t support “PrePaid” when region and oppositeregion are the same. :param pulumi.Input[str] name: Name of the router interface. Length must be 2-80 characters long. Only Chinese characters, English letters, numbers, period (.), underline (), or dash (-) are permitted.

If it is not specified, the default value is interface ID. The name cannot start with http:// and https://.

Parameters
  • opposite_access_point_id (pulumi.Input[str]) – It has been deprecated from version 1.11.0.

  • opposite_region (pulumi.Input[str]) – The Region of peer side.

  • period (pulumi.Input[float]) – The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid values: [1-9, 12, 24, 36]. At present, the provider does not support modify “period” and you can do that via web console.

  • role (pulumi.Input[str]) – The role the router interface plays. Optional value: InitiatingSide, AcceptingSide.

  • router_id (pulumi.Input[str]) – The Router ID.

  • router_type (pulumi.Input[str]) – Router Type. Optional value: VRouter, VBR. Accepting side router interface type only be VRouter.

  • specification (pulumi.Input[str]) – Specification of router interfaces. It is valid when role is InitiatingSide. Accepting side’s role is default to set as ‘Negative’. For more about the specification, refer to Router interface specification.

access_point_id: pulumi.Output[str] = None

It has been deprecated from version 1.11.0.

description: pulumi.Output[str] = None

Description of the router interface. It can be 2-256 characters long or left blank. It cannot start with http:// and https://.

health_check_source_ip: pulumi.Output[str] = None

Used as the Packet Source IP of health check for disaster recovery or ECMP. It is only valid when router_type is VBR. The IP must be an unused IP in the local VPC. It and health_check_target_ip must be specified at the same time.

health_check_target_ip: pulumi.Output[str] = None

Used as the Packet Target IP of health check for disaster recovery or ECMP. It is only valid when router_type is VBR. The IP must be an unused IP in the local VPC. It and health_check_source_ip must be specified at the same time.

instance_charge_type: pulumi.Output[str] = None

The billing method of the router interface. Valid values are “PrePaid” and “PostPaid”. Default to “PostPaid”. Router Interface doesn’t support “PrePaid” when region and opposite_region are the same.

name: pulumi.Output[str] = None

Name of the router interface. Length must be 2-80 characters long. Only Chinese characters, English letters, numbers, period (.), underline (_), or dash (-) are permitted. If it is not specified, the default value is interface ID. The name cannot start with http:// and https://.

opposite_access_point_id: pulumi.Output[str] = None

It has been deprecated from version 1.11.0.

opposite_interface_id: pulumi.Output[str] = None

It has been deprecated from version 1.11.0. Use resource alicloud_router_interface_connection’s ‘opposite_router_id’ instead.

opposite_interface_owner_id: pulumi.Output[str] = None

It has been deprecated from version 1.11.0. Use resource alicloud_router_interface_connection’s ‘opposite_interface_id’ instead.

opposite_region: pulumi.Output[str] = None

The Region of peer side.

opposite_router_id: pulumi.Output[str] = None

It has been deprecated from version 1.11.0. Use resource alicloud_router_interface_connection’s ‘opposite_router_id’ instead.

opposite_router_type: pulumi.Output[str] = None

It has been deprecated from version 1.11.0. resource alicloud_router_interface_connection’s ‘opposite_router_type’ instead.

period: pulumi.Output[float] = None

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid values: [1-9, 12, 24, 36]. At present, the provider does not support modify “period” and you can do that via web console.

role: pulumi.Output[str] = None

The role the router interface plays. Optional value: InitiatingSide, AcceptingSide.

router_id: pulumi.Output[str] = None

The Router ID.

router_type: pulumi.Output[str] = None

Router Type. Optional value: VRouter, VBR. Accepting side router interface type only be VRouter.

specification: pulumi.Output[str] = None

Specification of router interfaces. It is valid when role is InitiatingSide. Accepting side’s role is default to set as ‘Negative’. For more about the specification, refer to Router interface specification.

static get(resource_name, id, opts=None, access_point_id=None, description=None, health_check_source_ip=None, health_check_target_ip=None, instance_charge_type=None, name=None, opposite_access_point_id=None, opposite_interface_id=None, opposite_interface_owner_id=None, opposite_region=None, opposite_router_id=None, opposite_router_type=None, period=None, role=None, router_id=None, router_type=None, specification=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • access_point_id (pulumi.Input[str]) – It has been deprecated from version 1.11.0.

  • description (pulumi.Input[str]) – Description of the router interface. It can be 2-256 characters long or left blank. It cannot start with http:// and https://.

  • health_check_source_ip (pulumi.Input[str]) – Used as the Packet Source IP of health check for disaster recovery or ECMP. It is only valid when router_type is VBR. The IP must be an unused IP in the local VPC. It and health_check_target_ip must be specified at the same time.

  • health_check_target_ip (pulumi.Input[str]) – Used as the Packet Target IP of health check for disaster recovery or ECMP. It is only valid when router_type is VBR. The IP must be an unused IP in the local VPC. It and health_check_source_ip must be specified at the same time.

  • instance_charge_type (pulumi.Input[str]) – The billing method of the router interface. Valid values are “PrePaid” and “PostPaid”. Default to “PostPaid”. Router Interface doesn’t support “PrePaid” when region and opposite*region are the same.

  • name (pulumi.Input[str]) – Name of the router interface. Length must be 2-80 characters long. Only Chinese characters, English letters, numbers, period (.), underline (*), or dash (-) are permitted. If it is not specified, the default value is interface ID. The name cannot start with http:// and https://.

  • opposite_access_point_id (pulumi.Input[str]) – It has been deprecated from version 1.11.0.

  • opposite_interface_id (pulumi.Input[str]) – It has been deprecated from version 1.11.0. Use resource alicloud_router_interface_connection’s ‘opposite_router_id’ instead.

  • opposite_interface_owner_id (pulumi.Input[str]) – It has been deprecated from version 1.11.0. Use resource alicloud_router_interface_connection’s ‘opposite_interface_id’ instead.

  • opposite_region (pulumi.Input[str]) – The Region of peer side.

  • opposite_router_id (pulumi.Input[str]) – It has been deprecated from version 1.11.0. Use resource alicloud_router_interface_connection’s ‘opposite_router_id’ instead.

  • opposite_router_type (pulumi.Input[str]) – It has been deprecated from version 1.11.0. resource alicloud_router_interface_connection’s ‘opposite_router_type’ instead.

  • period (pulumi.Input[float]) – The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid values: [1-9, 12, 24, 36]. At present, the provider does not support modify “period” and you can do that via web console.

  • role (pulumi.Input[str]) – The role the router interface plays. Optional value: InitiatingSide, AcceptingSide.

  • router_id (pulumi.Input[str]) – The Router ID.

  • router_type (pulumi.Input[str]) – Router Type. Optional value: VRouter, VBR. Accepting side router interface type only be VRouter.

  • specification (pulumi.Input[str]) –

    Specification of router interfaces. It is valid when role is InitiatingSide. Accepting side’s role is default to set as ‘Negative’. For more about the specification, refer to Router interface specification.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.RouterInterfaceConnection(resource_name, opts=None, interface_id=None, opposite_interface_id=None, opposite_interface_owner_id=None, opposite_router_id=None, opposite_router_type=None, __props__=None, __name__=None, __opts__=None)

Provides a VPC router interface connection resource to connect two router interfaces which are in two different VPCs. After that, all of the two router interfaces will be active.

NOTE: At present, Router interface does not support changing opposite router interface, the connection delete action is only deactivating it to inactive, not modifying the connection to empty.

NOTE: If you want to changing opposite router interface, you can delete router interface and re-build them.

NOTE: A integrated router interface connection tunnel requires both InitiatingSide and AcceptingSide configuring opposite router interface.

NOTE: Please remember to add a depends_on clause in the router interface connection from the InitiatingSide to the AcceptingSide, because the connection from the AcceptingSide to the InitiatingSide must be done first.

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
region = config.get("region")
if region is None:
    region = "cn-hangzhou"
name = config.get("name")
if name is None:
    name = "alicloudRouterInterfaceConnectionBasic"
foo_network = alicloud.vpc.Network("fooNetwork", cidr_block="172.16.0.0/12")
bar_network = alicloud.vpc.Network("barNetwork", cidr_block="192.168.0.0/16")
initiate = alicloud.vpc.RouterInterface("initiate",
    description=name,
    instance_charge_type="PostPaid",
    opposite_region=region,
    role="InitiatingSide",
    router_id=foo_network.router_id,
    router_type="VRouter",
    specification="Large.2")
opposite = alicloud.vpc.RouterInterface("opposite",
    description=f"{name}-opposite",
    opposite_region=region,
    role="AcceptingSide",
    router_id=bar_network.router_id,
    router_type="VRouter",
    specification="Large.1")
# A integrated router interface connection tunnel requires both InitiatingSide and AcceptingSide configuring opposite router interface.
foo_router_interface_connection = alicloud.vpc.RouterInterfaceConnection("fooRouterInterfaceConnection",
    interface_id=initiate.id,
    opposite_interface_id=opposite.id)
bar_router_interface_connection = alicloud.vpc.RouterInterfaceConnection("barRouterInterfaceConnection",
    interface_id=opposite.id,
    opposite_interface_id=initiate.id)
Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • interface_id (pulumi.Input[str]) – One side router interface ID.

  • opposite_interface_id (pulumi.Input[str]) – Another side router interface ID. It must belong the specified “opposite_interface_owner_id” account.

  • opposite_router_id (pulumi.Input[str]) – Another side router ID. It must belong the specified “opposite_interface_owner_id” account. It is valid when field “opposite_interface_owner_id” is specified.

  • opposite_router_type (pulumi.Input[str]) – Another side router Type. Optional value: VRouter, VBR. It is valid when field “opposite_interface_owner_id” is specified.

interface_id: pulumi.Output[str] = None

One side router interface ID.

opposite_interface_id: pulumi.Output[str] = None

Another side router interface ID. It must belong the specified “opposite_interface_owner_id” account.

opposite_router_id: pulumi.Output[str] = None

Another side router ID. It must belong the specified “opposite_interface_owner_id” account. It is valid when field “opposite_interface_owner_id” is specified.

opposite_router_type: pulumi.Output[str] = None

Another side router Type. Optional value: VRouter, VBR. It is valid when field “opposite_interface_owner_id” is specified.

static get(resource_name, id, opts=None, interface_id=None, opposite_interface_id=None, opposite_interface_owner_id=None, opposite_router_id=None, opposite_router_type=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • interface_id (pulumi.Input[str]) – One side router interface ID.

  • opposite_interface_id (pulumi.Input[str]) – Another side router interface ID. It must belong the specified “opposite_interface_owner_id” account.

  • opposite_router_id (pulumi.Input[str]) – Another side router ID. It must belong the specified “opposite_interface_owner_id” account. It is valid when field “opposite_interface_owner_id” is specified.

  • opposite_router_type (pulumi.Input[str]) – Another side router Type. Optional value: VRouter, VBR. It is valid when field “opposite_interface_owner_id” is specified.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.SnatEntry(resource_name, opts=None, snat_entry_name=None, snat_ip=None, snat_table_id=None, source_cidr=None, source_vswitch_id=None, __props__=None, __name__=None, __opts__=None)

Provides a snat resource.

Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • snat_entry_name (pulumi.Input[str]) – The name of snat entry.

  • snat_ip (pulumi.Input[str]) – The SNAT ip address, the ip must along bandwidth package public ip which vpc.NatGateway argument bandwidth_packages.

  • snat_table_id (pulumi.Input[str]) – The value can get from vpc.NatGateway Attributes “snat_table_ids”.

  • source_cidr (pulumi.Input[str]) – The private network segment of Ecs. This parameter and the source_vswitch_id parameter are mutually exclusive and cannot appear at the same time.

  • source_vswitch_id (pulumi.Input[str]) – The vswitch ID.

snat_entry_id: pulumi.Output[str] = None

The id of the snat entry on the server.

snat_entry_name: pulumi.Output[str] = None

The name of snat entry.

snat_ip: pulumi.Output[str] = None

The SNAT ip address, the ip must along bandwidth package public ip which vpc.NatGateway argument bandwidth_packages.

snat_table_id: pulumi.Output[str] = None

The value can get from vpc.NatGateway Attributes “snat_table_ids”.

source_cidr: pulumi.Output[str] = None

The private network segment of Ecs. This parameter and the source_vswitch_id parameter are mutually exclusive and cannot appear at the same time.

source_vswitch_id: pulumi.Output[str] = None

The vswitch ID.

static get(resource_name, id, opts=None, snat_entry_id=None, snat_entry_name=None, snat_ip=None, snat_table_id=None, source_cidr=None, source_vswitch_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • snat_entry_id (pulumi.Input[str]) – The id of the snat entry on the server.

  • snat_entry_name (pulumi.Input[str]) – The name of snat entry.

  • snat_ip (pulumi.Input[str]) – The SNAT ip address, the ip must along bandwidth package public ip which vpc.NatGateway argument bandwidth_packages.

  • snat_table_id (pulumi.Input[str]) – The value can get from vpc.NatGateway Attributes “snat_table_ids”.

  • source_cidr (pulumi.Input[str]) – The private network segment of Ecs. This parameter and the source_vswitch_id parameter are mutually exclusive and cannot appear at the same time.

  • source_vswitch_id (pulumi.Input[str]) – The vswitch ID.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.Subnet(resource_name, opts=None, availability_zone=None, cidr_block=None, description=None, name=None, tags=None, vpc_id=None, __props__=None, __name__=None, __opts__=None)

Create a Subnet resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource.

static get(resource_name, id, opts=None, availability_zone=None, cidr_block=None, description=None, name=None, tags=None, vpc_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_alicloud.vpc.Switch(resource_name, opts=None, availability_zone=None, cidr_block=None, description=None, name=None, tags=None, vpc_id=None, __props__=None, __name__=None, __opts__=None)

Create a Switch resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[str] availability_zone: The AZ for the switch. :param pulumi.Input[str] cidr_block: The CIDR block for the switch. :param pulumi.Input[str] description: The switch description. Defaults to null. :param pulumi.Input[str] name: The name of the switch. Defaults to null. :param pulumi.Input[dict] tags: A mapping of tags to assign to the resource. :param pulumi.Input[str] vpc_id: The VPC ID.

availability_zone: pulumi.Output[str] = None

The AZ for the switch.

cidr_block: pulumi.Output[str] = None

The CIDR block for the switch.

description: pulumi.Output[str] = None

The switch description. Defaults to null.

name: pulumi.Output[str] = None

The name of the switch. Defaults to null.

tags: pulumi.Output[dict] = None

A mapping of tags to assign to the resource.

vpc_id: pulumi.Output[str] = None

The VPC ID.

static get(resource_name, id, opts=None, availability_zone=None, cidr_block=None, description=None, name=None, tags=None, vpc_id=None)

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

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • availability_zone (pulumi.Input[str]) – The AZ for the switch.

  • cidr_block (pulumi.Input[str]) – The CIDR block for the switch.

  • description (pulumi.Input[str]) – The switch description. Defaults to null.

  • name (pulumi.Input[str]) – The name of the switch. Defaults to null.

  • tags (pulumi.Input[dict]) – A mapping of tags to assign to the resource.

  • vpc_id (pulumi.Input[str]) – The VPC ID.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

pulumi_alicloud.vpc.get_common_bandwidth_packages(ids=None, name_regex=None, output_file=None, resource_group_id=None, opts=None)

This data source provides a list of Common Bandwidth Packages owned by an Alibaba Cloud account.

NOTE: Available in 1.36.0+.

import pulumi
import pulumi_alicloud as alicloud

foo_common_bandwith_package = alicloud.vpc.CommonBandwithPackage("fooCommonBandwithPackage",
    bandwidth="2",
    description="tf-testAcc-CommonBandwidthPackage")
foo_common_bandwidth_packages = foo_common_bandwith_package.id.apply(lambda id: alicloud.vpc.get_common_bandwidth_packages(ids=[id],
    name_regex="^tf-testAcc.*"))

The public ip addresses mapping supports the following:

  • ip_address - The address of the EIP.

  • allocation_id - The ID of the EIP instance.

Parameters
  • ids (list) – A list of Common Bandwidth Packages IDs.

  • name_regex (str) – A regex string to filter results by name.

  • resource_group_id (str) – The Id of resource group which the common bandwidth package belongs.

pulumi_alicloud.vpc.get_forward_entries(external_ip=None, forward_table_id=None, ids=None, internal_ip=None, name_regex=None, names=None, output_file=None, opts=None)

This data source provides a list of Forward Entries owned by an Alibaba Cloud account.

NOTE: Available in 1.37.0+.

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "forward-entry-config-example-name"
default_zones = alicloud.get_zones(available_resource_creation="VSwitch")
default_network = alicloud.vpc.Network("defaultNetwork", cidr_block="172.16.0.0/12")
default_switch = alicloud.vpc.Switch("defaultSwitch",
    availability_zone=default_zones.zones[0]["id"],
    cidr_block="172.16.0.0/21",
    vpc_id=default_network.id)
default_nat_gateway = alicloud.vpc.NatGateway("defaultNatGateway",
    specification="Small",
    vpc_id=default_network.id)
default_eip = alicloud.ecs.Eip("defaultEip")
default_eip_association = alicloud.ecs.EipAssociation("defaultEipAssociation",
    allocation_id=default_eip.id,
    instance_id=default_nat_gateway.id)
default_forward_entry = alicloud.vpc.ForwardEntry("defaultForwardEntry",
    external_ip=default_eip.ip_address,
    external_port="80",
    forward_table_id=default_nat_gateway.forward_table_ids,
    internal_ip="172.16.0.3",
    internal_port="8080",
    ip_protocol="tcp")
default_forward_entries = default_forward_entry.forward_table_id.apply(lambda forward_table_id: alicloud.vpc.get_forward_entries(forward_table_id=forward_table_id))
Parameters
  • external_ip (str) – The public IP address.

  • forward_table_id (str) – The ID of the Forward table.

  • ids (list) – A list of Forward Entries IDs.

  • internal_ip (str) – The private IP address.

  • name_regex (str) – A regex string to filter results by forward entry name.

  • names (list) – A list of Forward Entries names.

pulumi_alicloud.vpc.get_nat_gateways(ids=None, name_regex=None, output_file=None, vpc_id=None, opts=None)

This data source provides a list of Nat Gateways owned by an Alibaba Cloud account.

NOTE: Available in 1.37.0+.

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "natGatewaysDatasource"
default = alicloud.get_zones(available_resource_creation="VSwitch")
foo_network = alicloud.vpc.Network("fooNetwork", cidr_block="172.16.0.0/12")
foo_nat_gateway = alicloud.vpc.NatGateway("fooNatGateway",
    specification="Small",
    vpc_id=foo_network.id)
foo_nat_gateways = pulumi.Output.all(foo_nat_gateway.id, foo_nat_gateway.name, foo_network.id).apply(lambda fooNatGatewayId, name, fooNetworkId: alicloud.vpc.get_nat_gateways(ids=[foo_nat_gateway_id],
    name_regex=name,
    vpc_id=foo_network_id))
Parameters
  • ids (list) – A list of NAT gateways IDs.

  • name_regex (str) – A regex string to filter nat gateways by name.

  • vpc_id (str) – The ID of the VPC.

pulumi_alicloud.vpc.get_networks(cidr_block=None, ids=None, is_default=None, name_regex=None, output_file=None, resource_group_id=None, status=None, tags=None, vswitch_id=None, opts=None)

This data source provides VPCs available to the user.

import pulumi
import pulumi_alicloud as alicloud

vpcs_ds = alicloud.vpc.get_networks(cidr_block="172.16.0.0/12",
    name_regex="^foo",
    status="Available")
pulumi.export("firstVpcId", vpcs_ds.vpcs[0]["id"])
Parameters
  • cidr_block (str) – Filter results by a specific CIDR block. For example: “172.16.0.0/12”.

  • ids (list) – A list of VPC IDs.

  • is_default (bool) – Indicate whether the VPC is the default one in the specified region.

  • name_regex (str) – A regex string to filter VPCs by name.

  • resource_group_id (str) – The Id of resource group which VPC belongs.

  • status (str) – Filter results by a specific status. Valid value are Pending and Available.

  • tags (dict) – A mapping of tags to assign to the resource.

  • vswitch_id (str) – Filter results by the specified VSwitch.

pulumi_alicloud.vpc.get_route_entries(cidr_block=None, instance_id=None, output_file=None, route_table_id=None, type=None, opts=None)

This data source provides a list of Route Entries owned by an Alibaba Cloud account.

NOTE: Available in 1.37.0+.

import pulumi
import pulumi_alicloud as alicloud

default_zones = alicloud.get_zones(available_resource_creation="VSwitch")
default_instance_types = alicloud.ecs.get_instance_types(availability_zone=default_zones.zones[0]["id"],
    cpu_core_count=1,
    memory_size=2)
default_images = alicloud.ecs.get_images(most_recent=True,
    name_regex="^ubuntu_18.*64",
    owners="system")
config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "tf-testAccRouteEntryConfig"
foo_network = alicloud.vpc.Network("fooNetwork", cidr_block="10.1.0.0/21")
foo_switch = alicloud.vpc.Switch("fooSwitch",
    availability_zone=default_zones.zones[0]["id"],
    cidr_block="10.1.1.0/24",
    vpc_id=foo_network.id)
tf_test_foo = alicloud.ecs.SecurityGroup("tfTestFoo",
    description="foo",
    vpc_id=foo_network.id)
foo_instance = alicloud.ecs.Instance("fooInstance",
    allocate_public_ip=True,
    image_id=default_images.images[0]["id"],
    instance_charge_type="PostPaid",
    instance_name=name,
    instance_type=default_instance_types.instance_types[0]["id"],
    internet_charge_type="PayByTraffic",
    internet_max_bandwidth_out=5,
    security_groups=[tf_test_foo.id],
    system_disk_category="cloud_efficiency",
    vswitch_id=foo_switch.id)
foo_route_entry = alicloud.vpc.RouteEntry("fooRouteEntry",
    destination_cidrblock="172.11.1.1/32",
    nexthop_id=foo_instance.id,
    nexthop_type="Instance",
    route_table_id=foo_network.route_table_id)
ingress = alicloud.ecs.SecurityGroupRule("ingress",
    cidr_ip="0.0.0.0/0",
    ip_protocol="tcp",
    nic_type="intranet",
    policy="accept",
    port_range="22/22",
    priority=1,
    security_group_id=tf_test_foo.id,
    type="ingress")
foo_route_entries = foo_route_entry.route_table_id.apply(lambda route_table_id: alicloud.vpc.get_route_entries(route_table_id=route_table_id))
Parameters
  • cidr_block (str) – The destination CIDR block of the route entry.

  • instance_id (str) – The instance ID of the next hop.

  • route_table_id (str) – The ID of the router table to which the route entry belongs.

  • type (str) – The type of the route entry.

pulumi_alicloud.vpc.get_route_tables(ids=None, name_regex=None, output_file=None, resource_group_id=None, tags=None, vpc_id=None, opts=None)

This data source provides a list of Route Tables owned by an Alibaba Cloud account.

NOTE: Available in 1.36.0+.

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "route-tables-datasource-example-name"
foo_network = alicloud.vpc.Network("fooNetwork", cidr_block="172.16.0.0/12")
foo_route_table = alicloud.vpc.RouteTable("fooRouteTable",
    description=name,
    vpc_id=foo_network.id)
foo_route_tables = foo_route_table.id.apply(lambda id: alicloud.vpc.get_route_tables(ids=[id]))
pulumi.export("routeTableIds", foo_route_tables.ids)
Parameters
  • ids (list) – A list of Route Tables IDs.

  • name_regex (str) – A regex string to filter route tables by name.

  • resource_group_id (str) – The Id of resource group which route tables belongs.

  • tags (dict) – A mapping of tags to assign to the resource.

  • vpc_id (str) – Vpc id of the route table.

pulumi_alicloud.vpc.get_router_interfaces(ids=None, name_regex=None, opposite_interface_id=None, opposite_interface_owner_id=None, output_file=None, role=None, router_id=None, router_type=None, specification=None, status=None, opts=None)

This data source provides information about router interfaces that connect VPCs together.

import pulumi
import pulumi_alicloud as alicloud

router_interfaces_ds = alicloud.vpc.get_router_interfaces(name_regex="^testenv",
    status="Active")
pulumi.export("firstRouterInterfaceId", router_interfaces_ds.interfaces[0]["id"])
Parameters
  • ids (list) – A list of router interface IDs.

  • name_regex (str) – A regex string used to filter by router interface name.

  • opposite_interface_id (str) – ID of the peer router interface.

  • opposite_interface_owner_id (str) – Account ID of the owner of the peer router interface.

  • role (str) – Role of the router interface. Valid values are InitiatingSide (connection initiator) and AcceptingSide (connection receiver). The value of this parameter must be InitiatingSide if the router_type is set to VBR.

  • router_id (str) – ID of the VRouter located in the local region.

  • router_type (str) – Router type in the local region. Valid values are VRouter and VBR (physical connection).

  • specification (str) – Specification of the link, such as Small.1 (10Mb), Middle.1 (100Mb), Large.2 (2Gb), …etc.

  • status (str) – Expected status. Valid values are Active, Inactive and Idle.

pulumi_alicloud.vpc.get_snat_entries(ids=None, output_file=None, snat_ip=None, snat_table_id=None, source_cidr=None, opts=None)

This data source provides a list of Snat Entries owned by an Alibaba Cloud account.

NOTE: Available in 1.37.0+.

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "snat-entry-example-name"
default = alicloud.get_zones(available_resource_creation="VSwitch")
foo_network = alicloud.vpc.Network("fooNetwork", cidr_block="172.16.0.0/12")
foo_switch = alicloud.vpc.Switch("fooSwitch",
    availability_zone=default.zones[0]["id"],
    cidr_block="172.16.0.0/21",
    vpc_id=foo_network.id)
foo_nat_gateway = alicloud.vpc.NatGateway("fooNatGateway",
    specification="Small",
    vpc_id=foo_network.id)
foo_eip = alicloud.ecs.Eip("fooEip")
foo_eip_association = alicloud.ecs.EipAssociation("fooEipAssociation",
    allocation_id=foo_eip.id,
    instance_id=foo_nat_gateway.id)
foo_snat_entry = alicloud.vpc.SnatEntry("fooSnatEntry",
    snat_ip=foo_eip.ip_address,
    snat_table_id=foo_nat_gateway.snat_table_ids,
    source_vswitch_id=foo_switch.id)
foo_snat_entries = foo_snat_entry.snat_table_id.apply(lambda snat_table_id: alicloud.vpc.get_snat_entries(snat_table_id=snat_table_id))
Parameters
  • ids (list) – A list of Snat Entries IDs.

  • snat_ip (str) – The public IP of the Snat Entry.

  • snat_table_id (str) – The ID of the Snat table.

  • source_cidr (str) – The source CIDR block of the Snat Entry.

pulumi_alicloud.vpc.get_ssl_vpn_client_certs(ids=None, name_regex=None, output_file=None, ssl_vpn_server_id=None, opts=None)

The SSL-VPN client certificates data source lists lots of SSL-VPN client certificates resource information owned by an Alicloud account.

import pulumi
import pulumi_alicloud as alicloud

foo = alicloud.vpc.get_ssl_vpn_client_certs(ids=["fake-cert-id"],
    name_regex="^foo",
    output_file="/tmp/clientcert",
    ssl_vpn_server_id="fake-server-id")
Parameters
  • ids (list) – IDs of the SSL-VPN client certificates.

  • name_regex (str) – A regex string of SSL-VPN client certificate name.

  • output_file (str) – Save the result to the file.

  • ssl_vpn_server_id (str) – Use the SSL-VPN server ID as the search key.

pulumi_alicloud.vpc.get_ssl_vpn_servers(ids=None, name_regex=None, output_file=None, vpn_gateway_id=None, opts=None)

The SSL-VPN servers data source lists lots of SSL-VPN servers resource information owned by an Alicloud account.

import pulumi
import pulumi_alicloud as alicloud

foo = alicloud.vpc.get_ssl_vpn_servers(ids=["fake-server-id"],
    name_regex="^foo",
    output_file="/tmp/sslserver",
    vpn_gateway_id="fake-vpn-id")
Parameters
  • ids (list) – IDs of the SSL-VPN servers.

  • name_regex (str) – A regex string of SSL-VPN server name.

  • output_file (str) – Save the result to the file.

  • vpn_gateway_id (str) – Use the VPN gateway ID as the search key.

pulumi_alicloud.vpc.get_switches(cidr_block=None, ids=None, is_default=None, name_regex=None, output_file=None, resource_group_id=None, tags=None, vpc_id=None, zone_id=None, opts=None)

This data source provides a list of VSwitches owned by an Alibaba Cloud account.

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "vswitchDatasourceName"
default_zones = alicloud.get_zones()
vpc = alicloud.vpc.Network("vpc", cidr_block="172.16.0.0/16")
vswitch = alicloud.vpc.Switch("vswitch",
    availability_zone=default_zones.zones[0]["id"],
    cidr_block="172.16.0.0/24",
    vpc_id=vpc.id)
default_switches = vswitch.name.apply(lambda name: alicloud.vpc.get_switches(name_regex=name))
Parameters
  • cidr_block (str) – Filter results by a specific CIDR block. For example: “172.16.0.0/12”.

  • ids (list) – A list of VSwitch IDs.

  • is_default (bool) – Indicate whether the VSwitch is created by the system.

  • name_regex (str) – A regex string to filter results by name.

  • resource_group_id (str) – The Id of resource group which VSWitch belongs.

  • tags (dict) – A mapping of tags to assign to the resource.

  • vpc_id (str) – ID of the VPC that owns the VSwitch.

  • zone_id (str) – The availability zone of the VSwitch.