Resources / Subnet

Subnet

An address range (a prefix) on a VPC's Ethernet segment. Every VPC has a default subnet, named <vpc>-default, with the VPC's own prefix; members that name no subnet are in it. A subnet is an addressing and routing construct, not a security boundary: all members of a VPC share one segment; separation needs separate VPCs.

Overview

APInetwork.etorm.com/v1alpha1
Resourcesubnets (cluster-scoped inside its cluster)
Short namessubnet
Available inproject clusters only
Statuswritten by a controller through /status

Minimal example

apiVersion: network.etorm.com/v1alpha1
kind: Subnet
metadata:
  name: example
spec:
  vpcRef:
    name: "<name>"

Spec

FieldTypeRequiredDefaultAllowedDescription
vpcRefreference to VPCyesThe VPC this range belongs to. Cannot be changed.
ipv6Prefixstringup to 43 charactersThe subnet's IPv6 /64 with a zero host part, for example fd12:3456:789a:1::/64. Omit it to get a unique-local /64 chosen for you (it is then written here). Must not overlap the VPC's own prefix or another subnet's. Cannot be changed.
cidrstringup to 18 charactersOptional IPv4 network of the subnet, /16 to /29. Omit for an IPv6-only subnet. Must not overlap the VPC's cidr or another subnet's. Cannot be changed.
mtuinteger576 to 1350Largest packet in the subnet, at most the VPC's MTU. Advertised in the subnet's router advertisements once the gateway routes between subnets.
crossSubnetstring (one of)"allow"allow, denyWhat the gateway routes between this subnet and the other subnets of the same VPC: allow, or deny to block routed traffic through the gateway. Members of one VPC still share one L2 segment, so this is not isolation: isolation needs separate VPCs. Takes effect when the gateway routes between subnets; until then nothing is routed.

Status

FieldTypeRequiredDefaultAllowedDescription
phasestringPending until the VPC is Ready, then Ready.
ipv6PrefixstringThe subnet's effective IPv6 /64.
ipv6AddressstringThe gateway's address in the subnet (<prefix>::1/64).
gatewayAddressstringThe gateway's IPv4 address in the subnet (first host of cidr), when it has one.
defaultbooleanTrue for the subnet every VPC gets, which has the VPC's own prefix and cidr.
conditionslist of objectDetailed state, one entry per aspect; Ready says whether the subnet is usable.
conditions[].typestringAspect.
conditions[].statusstringTrue or False.
conditions[].reasonstringMachine-readable reason.
conditions[].messagestringHuman-readable detail.

Columns in listings

ColumnFrom
VPC.spec.vpcRef.name
IPv6.spec.ipv6Prefix
CIDR.spec.cidr
Cross-subnet.spec.crossSubnet
Phase.status.phase

All resources