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_typeisPayBy95. 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_typeisPayBy95. 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_typeisPayBy95. 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.NatGatewayargumentbandwidth_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.NatGatewayAttributes “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.NatGatewayargumentbandwidth_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.NatGatewayAttributes “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.NatGatewayargumentbandwidth_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.NatGatewayAttributes “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.
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:
InitiatingSideandAcceptingSide.
router_id= None¶ID of the VRouter located in the local region.
router_type= None¶Router type in the local region. Possible values:
VRouterandVBR.
specification= None¶Router interface specification. Possible values:
Small.1,Middle.1,Large.2, …etc.
status= None¶Router interface status. Possible values:
Active,InactiveandIdle.
- 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_typeisPrePaid. 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 areSmall,MiddleandLarge. Default toSmall. 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_idsis 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_typeisPrePaid. 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_idsis 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,MiddleandLarge. Default toSmall. 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_idsis 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_typeisPrePaid. 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_idsis 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,MiddleandLarge. Default toSmall. 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.
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 supportVSwitchnow.
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 supportVSwitchnow.
- 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 supportVSwitchnow.
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 becustomorsystem. Default value iscustom.name(pulumi.Input[str]) - The name of the egress entry.policy(pulumi.Input[str]) - The policy of the egress entry. It must beacceptordrop.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 becustomorsystem. Default value iscustom.name(pulumi.Input[str]) - The name of the egress entry.policy(pulumi.Input[str]) - The policy of the egress entry. It must beacceptordrop.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 becustomorsystem. Default value iscustom.name(str) - The name of the egress entry.policy(str) - The policy of the egress entry. It must beacceptordrop.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 becustomorsystem. Default value iscustom.name(str) - The name of the egress entry.policy(str) - The policy of the egress entry. It must beacceptordrop.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 becustomorsystem. Default value iscustom.name(pulumi.Input[str]) - The name of the egress entry.policy(pulumi.Input[str]) - The policy of the egress entry. It must beacceptordrop.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 becustomorsystem. Default value iscustom.name(pulumi.Input[str]) - The name of the egress entry.policy(pulumi.Input[str]) - The policy of the egress entry. It must beacceptordrop.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.
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.
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_typeisVBR. The IP must be an unused IP in the local VPC. It andhealth_check_target_ipmust 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 whenrouter_typeisVBR. The IP must be an unused IP in the local VPC. It andhealth_check_source_ipmust 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.- 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_typeisPrePaid. 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
roleisInitiatingSide. 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_typeisVBR. The IP must be an unused IP in the local VPC. It andhealth_check_target_ipmust 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_typeisVBR. The IP must be an unused IP in the local VPC. It andhealth_check_source_ipmust 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_typeisPrePaid. 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
roleisInitiatingSide. 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_typeisVBR. The IP must be an unused IP in the local VPC. It andhealth_check_target_ipmust 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_typeisVBR. The IP must be an unused IP in the local VPC. It andhealth_check_source_ipmust 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_typeisPrePaid. 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
roleisInitiatingSide. 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_onclause 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.NatGatewayargumentbandwidth_packages.snat_table_id (pulumi.Input[str]) – The value can get from
vpc.NatGatewayAttributes “snat_table_ids”.source_cidr (pulumi.Input[str]) – The private network segment of Ecs. This parameter and the
source_vswitch_idparameter 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.NatGatewayargumentbandwidth_packages.
snat_table_id: pulumi.Output[str] = None¶The value can get from
vpc.NatGatewayAttributes “snat_table_ids”.
source_cidr: pulumi.Output[str] = None¶The private network segment of Ecs. This parameter and the
source_vswitch_idparameter 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.NatGatewayargumentbandwidth_packages.snat_table_id (pulumi.Input[str]) – The value can get from
vpc.NatGatewayAttributes “snat_table_ids”.source_cidr (pulumi.Input[str]) – The private network segment of Ecs. This parameter and the
source_vswitch_idparameter 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
- static
- 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.
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
PendingandAvailable.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) andAcceptingSide(connection receiver). The value of this parameter must beInitiatingSideif therouter_typeis set toVBR.router_id (str) – ID of the VRouter located in the local region.
router_type (str) – Router type in the local region. Valid values are
VRouterandVBR(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,InactiveandIdle.
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.