AwsVpcDirectArgs
interface AwsVpcDirectArgs extends Omit<awsx.ec2.VpcArgs, 'availabilityZoneNames' | 'cidrBlock' | 'ipv4IpamPoolId' | 'numberOfAvailabilityZones' | 'tags' | 'subnetSpecs' | 'subnetStrategy' | 'natGateways'> {
assignGeneratedIpv6CidrBlock?: Input<boolean | undefined>;
availabilityZoneCidrMask?: number;
availabilityZones?: AwsVpcAvailabilityZones;
enableDnsHostnames?: Input<boolean | undefined>;
enableDnsSupport?: Input<boolean | undefined>;
enableNetworkAddressUsageMetrics?: Input<boolean | undefined>;
instanceTenancy?: Input<string | undefined>;
internetGatewayEnabled?: boolean;
ipv4CidrBlock?: string;
ipv4IpamPoolId?: Input<string>;
ipv4NetmaskLength?: Input<number | undefined>;
ipv6CidrBlock?: Input<string | undefined>;
ipv6CidrBlockNetworkBorderGroup?: Input<string | undefined>;
ipv6IpamPoolId?: Input<string | undefined>;
ipv6NetmaskLength?: Input<number | undefined>;
natGateways?: AwsVpcNatGatewayArgs;
region?: Input<string | undefined>;
subnetNameTagStrategy?: SubnetNameTagStrategy;
subnetSpecs?: AwsVpcSubnetSpecs;
subnetStrategy?: SubnetAllocationStrategy;
tags?: Input<Record<string, Input<string>>>;
vpcEndpointSpecs?: VpcEndpointSpecArgs[];
vpcEndpointStrategy?: VpcEndpointStrategy;
}Input arguments for direct VPC capability.
Example
import * as awsx from '@pulumi/awsx';
import type { AwsVpcDirectArgs } from '@jobcloud/aws-vpc';
const vpc: AwsVpcDirectArgs = {
ipv4CidrBlock: '198.51.100.0/24',
subnetStrategy: awsx.ec2.SubnetAllocationStrategy.Exact,
availabilityZones: {
euw1a: 'eu-west-1a',
},
subnetSpecs: {
application: {
type: awsx.ec2.SubnetType.Private,
name: 'application',
cidrBlocks: ['198.51.100.0/28'],
},
},
};Hierarchy
VpcArgs, "availabilityZoneNames" | "cidrBlock" | "ipv4IpamPoolId" | "numberOfAvailabilityZones" | "tags" | "subnetSpecs" | "subnetStrategy" | "natGateways">AwsVpcDirectArgs
Properties
assignGeneratedIpv6CidrBlock: Input<boolean | undefined>
Inherited from assignGeneratedIpv6CidrBlock
Requests an Amazon-provided IPv6 CIDR block with a /56 prefix length for the VPC. You cannot specify the range of IP addresses, or the size of the CIDR block. Default is false. Conflicts with ipv6IpamPoolId
availabilityZoneCidrMask: number
Inherited from availabilityZoneCidrMask
The netmask for each available zone to be aligned to. This is optional, the default value is inferred based on an even distribution of available space from the VPC's CIDR block after being divided evenly by the number of availability zones.
availabilityZones: AwsVpcAvailabilityZones
Stable, keyed availability zones used for subnet placement and subnet Name-tag child identity.
Remarks
Provide this when the component should create subnet Name tags. Without stable consumer keys the component creates only the VPC Name tag and leaves AWSX-generated subnet names untouched.
enableDnsHostnames: Input<boolean | undefined>
Inherited from enableDnsHostnames
A boolean flag to enable/disable DNS hostnames in the VPC. Defaults false.
enableDnsSupport: Input<boolean | undefined>
Inherited from enableDnsSupport
A boolean flag to enable/disable DNS support in the VPC. Defaults to true.
enableNetworkAddressUsageMetrics: Input<boolean | undefined>
Inherited from enableNetworkAddressUsageMetrics
Indicates whether Network Address Usage metrics are enabled for your VPC. Defaults to false.
instanceTenancy: Input<string | undefined>
Inherited from instanceTenancy
A tenancy option for instances launched into the VPC. Default is default, which ensures that EC2 instances launched in this VPC use the EC2 instance tenancy attribute specified when the EC2 instance is launched. The only other option is dedicated, which ensures that EC2 instances launched in this VPC are run on dedicated tenancy instances regardless of the tenancy attribute specified at launch. This has a dedicated per region fee of $2 per hour, plus an hourly per instance usage fee.
internetGatewayEnabled: boolean
Whether internet-gateway-backed networking is allowed for this VPC.
Remarks
Set to false for private-only VPC patterns. When disabled, public subnets are rejected and NAT strategy is forced to none.
Default: ```ts true ```
ipv4CidrBlock: string
Optional explicit IPv4 VPC CIDR block.
Remarks
Set exactly one of ipv4CidrBlock or ipv4IpamPoolId.
ipv4IpamPoolId: Input<string>
The IPv4 IPAM pool ID used to allocate VPC CIDR space.
Remarks
Set exactly one of ipv4IpamPoolId or ipv4CidrBlock.
ipv4NetmaskLength: Input<number | undefined>
Inherited from ipv4NetmaskLength
The netmask length of the IPv4 CIDR you want to allocate to this VPC. Requires specifying a ipv4IpamPoolId.
ipv6CidrBlock: Input<string | undefined>
Inherited from ipv6CidrBlock
IPv6 CIDR block to request from an IPAM Pool. Can be set explicitly or derived from IPAM using ipv6NetmaskLength.
ipv6CidrBlockNetworkBorderGroup: Input<string | undefined>
Inherited from ipv6CidrBlockNetworkBorderGroup
By default when an IPv6 CIDR is assigned to a VPC a default ipv6CidrBlockNetworkBorderGroup will be set to the region of the VPC. This can be changed to restrict advertisement of public addresses to specific Network Border Groups such as LocalZones.
ipv6IpamPoolId: Input<string | undefined>
Inherited from ipv6IpamPoolId
IPAM Pool ID for a IPv6 pool. Conflicts with assignGeneratedIpv6CidrBlock.
ipv6NetmaskLength: Input<number | undefined>
Inherited from ipv6NetmaskLength
Netmask length to request from IPAM Pool. Conflicts with ipv6CidrBlock. This can be omitted if IPAM pool as a allocationDefaultNetmaskLength set. Valid values are from 44 to 60 in increments of 4.
natGateways: AwsVpcNatGatewayArgs
Optional NAT gateway configuration.
region: Input<string | undefined>
Inherited from region
Region where this resource will be managed. Defaults to the Region set in the provider configuration.
subnetNameTagStrategy: SubnetNameTagStrategy
Inherited from subnetNameTagStrategy
Controls the AWS Name tags applied to generated subnets and their associated route tables. Pulumi logical resource names and URNs are unchanged. Optional; defaults to Legacy.
subnetSpecs: AwsVpcSubnetSpecs
Optional stable, keyed subnet specifications.
subnetStrategy: SubnetAllocationStrategy
Optional subnet allocation strategy.
Default: `auto`
tags: Input<Record<string, Input<string>>>
Optional tags merged with default ${namespace}:project and ${namespace}:env tags.
Remarks
The Name key is reserved: the VPC Name tag is derived from args.name, so passing a Name key here is rejected. When tags is a plain object the rejection is synchronous at construction; when it is a pulumi.Input (Output/promise) the rejection surfaces when the value resolves.
vpcEndpointSpecs: VpcEndpointSpecArgs[]
Inherited from vpcEndpointSpecs
A list of VPC Endpoints specs to be deployed as part of the VPC
vpcEndpointStrategy: VpcEndpointStrategy
Inherited from vpcEndpointStrategy
The strategy to use when applying VPC endpoint specs. Optional. Defaults to Legacy.